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Direct DMA to User Memory under NT. 6 

NT kernel mode device drivers run in a privileged processor mode, which means that 
moving data from the driver to your user mode program generally incurs the overhead 
of a ring transition. This article shows how to avoid that overhead by using direct DMA 
to user mode memory. The technique does not even use any interrupts, and can be 
especially useful with data acquisition boards. 

Dale Roberts 

A VxD to Monitor Hardware Interrupts. 23 

Under real-mode DOS, you could monitor hardware events just by hooking the appro¬ 
priate slots of the one and only interrupt vector. Under Windows and Win95, life is 
much more complicated. This article describes the undocumented multiple protected- 
mode interrupt descriptor tables that Windows uses, and shows how to accomplish the 
goal of directly hooking hardware interrupts. 

Jean-Frangois Larvoire 

Rotating Delphi Fonts. 39 

Delphi's TFont class provides most of the features of Windows fonts, but not all; for 
example, TFont does not directly provide the ability to rotate a font. This article shows 
how to use the Windows API along with TFont objects when you need absolute control 
over the attributes of a font. 

George Tylutki 


Columns 


Bug++ of the Month. 37 

Intel’s chips perform an amazing feat in allowing both 32-bit and 16-bit programs to 
execute in the same environment. Compilers aren’t always up to the task of this mix of 
sizes and capabilities, though. Reader Stefan Lippstreu shows a case where Visual 
C++ v2.2 loads a 16-bit value as a 32-bit value and uses the half-garbage result as an 
array index, with disastrous results. 

Mark Nelson 

Tech Tips. 47 

Piotr Markiewicz provides platform-independent code an app can use to obtain the 
path it was executed from. Gorkhmaz E. Mikailov shows how to animate a toolbar but¬ 
ton in MFC. Moshe Rubin discusses bugs in DDESPY and how to deal with them. Dan 
Shappir shows how to get faster builds by adding a single #def 1 ne. Homer B. Tilton 
shows the eight bytes needed to create a “messenger ”. com file. 

Leor Zolman 

Books in Brief. 53 

Foundations of Visual C++ Programming for Windows 95, by Paul Yao and Joseph 
Yao; Network Programming with Windows Sockets, by Pat Bonner (reviewed by Victor 
Volkman); Microsoft Secrets, by Michael A. Cusumano and Richard W. Selby; Borland 
Delphi How-To: The Definitive Delphi Problem Solver, by Gary Frerking, Nathan 
Wallace, and Wayne Niddery (reviewed by George Tylutki); Delphi Nuts & Bolts: For 
Experienced Programmers, by Gary Cornell and Troy Strain (reviewed by George 
Tylutki); Windows NT Networking Programming, by Ralph Davis (reviewed by Paula 
Tomlinson). 
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Understanding NT. 63 

One of the most prolific sources of incompatibility between NT and Win95 is in the reg¬ 
istry. This column outlines the differences most likely to break your program and, along 
the way, points out some recommended practices and common pitfalls in using the 
registry. 

Paula Tomlinson 

Windows Bug of the Month. 70 

Windows 95 is more robust than Windows 3.1 in some ways, but more fragile in others. 
Reader Thor Ivar Ekle shows that Windows 95 assumes the 80x86 direction flag is 
clear, and will usually crash immediately if that assumption is ever untrue. 
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System Commanded provides 
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exciting, new OSes to your PC. 
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From the Editor 


In the December issue, I neglected to remove a copyright notice from the code in 
John Rogers' popular article about a di rent library for Win32. Contrary to that copy¬ 
right notice, you have our complete permission to use this code in any personal or 
commercial application, as with virtually all the code we print. Apart from the occa¬ 
sional glitch like this, our Table of Contents page contains a statement explicitly giv¬ 
ing you permission to use the code that appears in the magazine, a handy thing to 
have if the boss wonders whether it's Okay. AT Do you do any data acquisition? 
Data Translation has a 256-page 1996 product handbook describing their data acqui¬ 
sition and imaging products. Get it free of charge by calling them at (800) 525-8528, 
or by sending email to info@datx.com, or via the Web at http://www.datx.com/. at 
Objects, Inc. now has its own separate CompuServe forum, supporting users and 
resellers of Layout. GO OBJECTS to check it out. AT NetManage is giving away 
their WebSurfer browser for free, 16-bit or 32-bit (NT) format. The browser features 
HTML 3.0 support, including inline video, True Speech and Real Audio players, cus¬ 
tom menu bar, hierarchical hotlist and offline caching. You can get it from 
http://www.netmanage.com, ftp://ftp.netmanage.com/pub/demos/websurfer/webl6.exe 
or ftp://ftp.netmanage.com/pub/demos/websurfer/web32.exe. at While we can't 
always manage to get major software companies to send us press releases, I am 
happy to announce that we now apparently get them from major pharmacological 
firms. This just in from Upjohn, a Web site for raising awareness of male impotence: 
http: //www. impotent. com. at With regret, I announce the end of our free t-shirts 
for SDK annotations. The new (but not so improved) Windows 95 documentation 
has generated a flood of annotations, with no end in sight. I hope readers will con¬ 
tinue to submit annotations, however, and we will continue to gather them up and 
distribute them (crediting the folks who submit each one, of course). AT The Delphi 
articles have started arriving, but we still are getting next to no Visual Basic article 
proposals. I know (from surveys, if nothing else) lots of you out there are writing VB 
code. When you write a reusable function to solve an irritating problem — why not 
tell me about it? Send email to 70302.2566@compuserve.com. at Do you skip over 
our "Understanding NT" column because you're not writing NT apps? You might 
want to keep an eye on that column anyway, because it often points out places where 
NT and Win95 differ. Why write code that won't port to NT if you don't have to? 
AT Okay, so our Web page wasn't quite up yet when the February issue arrived in 
your mailbox. But it really, really should be up now, so give it a try. Web your way 
over to http: //www. wdj. com and let us know what you think. □ 


Ron Burk 

Editor 

70302.2566@compuserve.com 


Drop in on our brand new Web site! 
You’ll find us at: 
http://www.wdj.com 

You’ll find information and excerpts from the 
current issue, along with links to WDJ code, 
including our SDK Annotations. 

Check it out — and let us know what you 
think. 
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OLE Custom Controls 

Just ask any OCX jockey. With Distinct’s Visual Internet 
Toolkit, adding TCP/IP connectivity to your application 
is not much farther than a drag-and-drop away. 
Whether you need a customized FTP client or most 
any other Internet application, you can simply embed 
an OCX into your program and Visual Internet 
will do the rest. It’s that easy. And you’ll have 
great looking, powerful applications. 
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Done! 
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32 Bit Performance 

The power of our new 32 bit Visual Internet Toolkit 
is simply unsurpassed. More custom controls. More 
protocols. More sample code. More Documentation. 
Which makes your job easier and leaves the 
competition in the dust. 
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Device Drivers 



Direct DMA to User Memory 
under NT 

Dale Roberts 


The Windows NT Device Driver Kit (DDK) provides a very complete, well- 
defined, and well-documented environment in which to create kernel-mode device 
drivers. NT also provides a nice facility for dynamically loading and unloading dri¬ 
vers, so you can recompile, reload, and test drivers in seconds. As long as your dri¬ 
ver doesn't crash or damage the system, there is never a need to reboot. For those 
among us who love to twiddle bits, writing device drivers for Windows NT can be, 
well, FUN! 

Data acquisition boards present an especially challenging task for device driver 
writers. Coordinating all of the activities of a data acquisition board (analog and dig¬ 
ital input and output, and timers) within a real-time environment can be tricky. 
Unfortunately, the NT DDK doesn't cover data acquisition devices very well. Its 
example drivers and interface libraries are for more mainstream devices, such as 
video cards, disk drives, network cards, sound cards, etc. This is probably because 
the market for general-purpose data acquisition cards (not counting audio and video 
capture cards) is relatively small and also because Windows is not a particularly 
friendly environment for real-time programs (due to unpredictable interrupt laten¬ 
cies). Although NT is better than regular Windows about providing a timely 
response to interrupts, it is still at the mercy of its device drivers, which, if poorly 
written, may lock out interrupts for long periods. 

This article describes an NT kernel-mode driver that allows a data acquisition 
card to use Direct Memory Access (DMA) to transfer samples from its analog to dig¬ 
ital (A/D) converter to a buffer that can be accessed directly by an application. It 
takes advantage of the "autoinitialize" mode of the PC's DMA controller so that 
samples are continuously written to a circular buffer without processor intervention. 
No interrupts are used. The driver may be queried to check the progress of the DMA 
within the buffer. 

To build the driver, you'll need the Windows NT DDK and Microsoft Visual C++ 
2.0 (32 bit version) or later. The code provided drives a National Instruments NT- 
MI016X card. Any other data acquisition card that supports continuous DMA will 
suffice, but you will need to write your own routines to start and stop DMA on your 
board. 

The code disk (see the Table of Contents for availability) contains the complete 
source needed to build the device driver for the National Instruments AT-MIO-16X 
card. Some of the more reusable portions of the device driver are displayed in the 
figures that accompany this article. I will provide an overview of how the device dri¬ 
ver works, along with examples of how to call it from a user application. 

DMA Operation 

In a world with no DMA, the microprocessor would have to be involved in every 
data transfer in the computer. To read data from a peripheral device, it would have 


Dale Roberts develops real-time data acquisition software at the Ocular Motor Vestibular 
Lab of the Johns Hopkins University School of Medicine. He can be reached at 
roberts@ishtar. med.jh u .edu. 

March 1996 











Ultimate TCP/IP 1 

Client & Server TCP/IP Controls 

A comprehensive suite of C++ tools that make developing TCP/IP 
applications a snap. Covers all functions from low level packet calls 
right up to a single function call to make a WWW server! 

Easily create both client and server type applications. Includes 
code to easily turn your projects into Windows NT services for a 
professional look and maximum performance. 

Build custom server applications in just minutes. Includes fully 
functional WWW, Finger, E-Mail and FTP server implementations. 

Just modify our sample code to get exactly what you want instantly. 

Our state-of-the-art multi-threaded design provides maximum 
performance and greatly simplifies the coding process. 

Using this library you can write a multi-threaded high performance 
NT server package in minutes. 

Integrates fully with MFC, OWL and SDK. 

Pricing: $199.00 / with source $499.00 
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Loading Message Data . . . 


An easy to use and very powerful grid tool that includes both 16 and 32 bit 
versions in one package. 

Works seamlessly with ODBC, BDE, standard databases, custom data files, 
memory arrays, memory mapped files, text files and more! Allows multiple 
datasources per grid, calculated fields and the display of real time data. 

Multiple class libraries work with MFC, OWL, the SDK and other framework 
products. One product covers all the bases. 

You will never outgrow the Ultimate Grid! It supports over 2 Billion rows, 32 
Thousand columns, custom cell styles and owner draw. You can even extend 
it's capabilities. You can override the built-in edit control to get the EXACT look 
and feel you want. 

All arid properties can be changed on-the-fly. Adjust the number of columns 
and/or rows, change individual cell styles, etc., etc. 
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Features galore! Inline masked editing, drag and drop, multiple text styles, 
bitmaps, check boxes, multiple selection, drop lists, multiple column sizing 
options. Other custom styles are also included. 

Includes comprehensive source code examples and demonstration code so 
you can get started right away. 

Pricing: $149.00/with source $349.00 
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The Ultimate Effects™ Control 

Create stunning visual effects in your applications using this amazing product! 

Includes more than 30 border/panel styles, including raised, recessed, gutter, bump, 
patterned, gradiant fills and more. 

Create plain or 3D text effects and have the text filled with plain colors, gradient fills, or 
for an amazing effect use a bitmap as the text color. 

Check our WWW site for visual examples of what this product can do! 

Pricing: $59.00 / with source $159.00 
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GetWindowText Length (2.x) 


t int GetWindowTextLength( hwnd ) 

HWND hwnd; /* handle of window with text*/ 

The GetWindowTextLength function retrieves the length, in bytes, of 
the text in the given window's title bar. If the window is a control, the 
length of the text within the control is retrieved. 
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Current annotation: 


Cancel 


Due to a bug in Windows 3.1, both H £ ave 

GetWindowTextLengthO and 
WM_GETTEXTLENGTH return -1 if you use it on a 
combobox of style CBS_DROPDOWNLIST. 
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to use IN and OUT instructions, or MOV 
instructions for memory-mapped 
devices. Simply moving bytes around is 
tedious, mindless work for an other¬ 
wise talented CPU. And moving data is 
not the processor's forte. Moving a byte 
from a peripheral to RAM requires a 
read from the peripheral to a CPU reg¬ 
ister, then a write to RAM; two steps. 
And the processor's I/O instructions 
(the IN and OUT family) are notoriously 
slow. Not only do they take many CPU 
clock cycles to execute, but, in order to 
provide absolute synchronization with 
external hardware, I/O instructions 
also cause the processor's write buffers 
to be cleared, and the execution of all 
other instructions in the processor's 
cache to be suspended until the I/O 
cycle completes. The upshot is that they 
waste a lot of processor time. Memory- 
mapped devices (like video cards) can 
be accessed much faster, but they still 
tie up the processor with busy-work. 
DMA can solve that problem. 

Direct Memory Access relies on 
hardware that is external to the proces¬ 
sor to access memory directly, hence its 
clever name. The external hardware 
may be provided either on the plug-in 
adapter board (this is called "busmas- 
ter" DMA) or on the system mother¬ 
board (this is called "system" DMA). 
The driver in this article uses system 
DMA, since most popular data acquisi¬ 
tion cards do not currently have bus- 
master capability. Although the PC's 
system DMA is also relatively slow (it 
tops off somewhere in the IMbyte/sec 
range) compared to the processor's 
data movement speed, its benefits are 
that it can transfer data while the CPU 
is doing useful work. Even more impor¬ 
tant, DMA can transfer data when the 
CPU is unable to. Without DMA, the 
CPU cannot respond to the data acqui¬ 
sition card's request for service while 
interrupts are disabled, which may 
cause data to be lost. With DMA, the 
external board can continue transfer¬ 
ring data to memory no matter what 
the CPU is doing. 

PC system DMA uses a pair of Intel 
8237 DMA controller chips (which 
nowadays are usually embedded inside 
a single chip along with other mother¬ 
board support devices) which allow 
data to be transferred 8 bits at a time 
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(using DMA channels 0 to 3) or 16 bits at a time (using DMA 
channels 5, 6, or 7). This driver uses 16-bit DMA, but can be 
easily modified to use the 8-bit variety. To start a DMA data 
transfer, you have to first set up the DMA controller so it 
knows the physical address of the data buffer and how many 
bytes or words to transfer. In DOS you had to program the 
8237 DMA controller yourself. NT, however, provides a sys¬ 
tem-independent interface to the DMA controller, as I will 
describe in the following section. Once the DMA controller 
and the data acquisition board are set up, the data transfer 
proceeds without further CPU intervention. 

"Normal" DMA usually consists of transferring a block of 
data from an I/O device into main memory (or vice versa), 
then stopping. A disk controller or network card, for instance, 
may transfer a sector or packet using 
DMA. When the transfer is complete, the 
processor is typically signaled with an 
interrupt so that it can retrieve the data 
from the buffer (or, for a write operation, 
put more data into the buffer) and ini¬ 
tialize the hardware for the next transfer. 

By contrast, "autoinitialize" DMA trans¬ 
fers data continuously to the same 
buffer, over and over. When it gets to the 
end of the buffer, instead of stopping 
and signaling the processor, it simply 
reloads the buffer start address and 
keeps going. 

So what good is a scheme like this 
where your data keeps getting overwrit¬ 
ten? Continuous DMA into a small, sin¬ 
gle sample buffer can be handy if, for 
instance, you just want to monitor some 
input signals and show them to a user. 

Your application might periodically 
update a graphical dial or a virtual strip 
chart recorder. If you need to access 
every data sample, to save to a file or 
perform some other processing, you can 
use a larger buffer with multiple sam¬ 
ples (hundreds or thousands). Then you 
can periodically check the progress of 
the DMA in the buffer and take action 
when necessary. 

Code Details 

NT kernel-mode device drivers make 
use of the kernel-mode support routines, 
which are described in the DDK docu¬ 
mentation. Application programmers 
who have used only the Win32 API will 
see nothing familiar here. NT kernel- 
mode drivers exist in a whole new 
world, with their own API. The support 
functions that make up the kernel-mode 
API are generally broken down into sev¬ 
eral categories, including Hal ... () (the 
Hardware Abstraction Layer, which 
hides the differences between the vari¬ 


ous machine platforms). Mm ... () (memory manager), 10 ... ( ) 
(Input/Output Request system support), Zw... () (file and 
mapping support), Rtl...() (standard C style Runtime 
Library support), and a few others. As you are scanning the 
driver source code listing, these function name prefixes let 
you know when the program is calling one of the support rou¬ 
tines. 

USERDMA (the name of my device driver) allocates its 
own DMA buffer when the driver is initially loaded (see sec¬ 
tion 3.3.4.2 of the NT Kernel Mode Driver Design Guide, 
"Common-Buffer System DMA"). The code in Figure 1 shows 
the driver function that handles the memory allocation: 
DMAA11 OCateBuffer (). The kernel-mode support function that 
actually allocates the memory is HalAUocateCommonBufferO, 
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-et’s face it - when you need a disassem¬ 
bler you're looking for clear, reliable informa¬ 
tion. Those who have tried other products 
have been disappointed with the dismal re¬ 
sults. 

Clearly, a new standard of excellence! 

Sourcer solves these problems with ad¬ 
vanced analysis and simulation. The quality 
of output is so good that most DOS EXE & 
COM files and drivers reassemble perfectly, 
byte-for-byte identical to the original! 

To make the results easier to understand 
Sourcer provides detailed and descriptive 
comments for interrupt subfunctions, I/O 
ports and much more. Sourcer even lets you 
examine encrypted and packed programs. 


mov ax,2517h 

mov dx,offset int_17h_entry 


mov dx.offset data_4 
mov ah ,9 
int 21 h 

mov dx,19h 
mov ah,31h 


endp 


DOS Services ah=function 25h 
; set intrpt vector al to ds:dx 
; ('Halt when ? printed.') 

; DOS Services ah=function 09h 
; display char string at ds:dx 


DOS Services ah=function 31 h 
terminate and stay resident 
a!=return code,dx=paragraphs 


int_17h_entry proc far 
pushf 

cmp al,3Fh 


; Push flags 


Partial Disassembly of a Virus 

C/C++ and Pascal 

Some C. C++ and Pascal developers hate 
disas sembly because the source code they get is 
assembly. We can't change that, but we can 
make it easier for you by automatically identi¬ 
fying the use of parameter passing and local 
stack variables. Parameters pushed onto the 
stack prior to a subroutine call are clearly com¬ 
mented. 

Get commented BIOS listings 
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drivers, & OS/2 NE files. Windows Source 
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V Communications, Inc. 
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but NT needs to know some specifics 
about the DMA device before it allo¬ 
cates the buffer. For instance, if your 
DMA controller does not support a 
scatter/gather (non-con tiguous memo¬ 
ry) mechanism (which is the case for 
system DMA), then the buffer must be 
allocated in a single, contiguous memo¬ 
ry block. Hal GetAdapter( ) is called with 
the DEVIC E_D ESC RIPTI ON structure, 
which contains the DMA specifics. 
Although the physical memory buffer 
size is fixed at driver load time, the 
number of samples to go into the buffer 
is determined by the user-mode appli¬ 
cation. The allocated size of the buffer 
places an upper limit (but not a lower 
limit, of course) on the number of sam¬ 
ples in the circular DMA buffer. In the 
context of this device driver, a "sample" 
refers to the digitized values for all 16 of 
the data acquisition board's channels. 
Since the A/D resolution is 16 bits, each 
digitized value takes up 2 bytes, so a 
complete sample (16 values, one per 
channel, of 2 bytes each) takes up 32 
bytes. 

Once the driver is loaded and the 


buffer is allocated, you can run the 
application that accesses the driver. 
After the application gets a handle to 
the driver using the Win32 
CreateFileO function, communication 
with the driver is achieved using 
Devi celoControl (). The driver supports 
START, STOP, and CUR_OFFSET functions. 
To keep things simple, the same 
USERDMA_INFO structure is used in all of 
the Devi celoControl () calls: 

typedef struct { 
short *buf; 

int NumChans; 

int NumSamps; 

int CurDMAWord; 

) USERDMAJNFO; 

The NumSamps field of USERDMAJNFO should 
be set to the desired value before DMA is 
started. When the application calls the 
driver with the START command, two 
things happen. First, the DMA is started 
(if it was not already started by another 
process). Then, the DMA buffer is 
mapped into the address space of the call¬ 
ing process (the user application). Figure 
2 shows the functions inside my device 
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LB_ADDSTRING Quicklnfo Overview Group 


<£LB_ADDSTRING 

wParam =0; // not use 

IParam = (LPARAM) (LPCTSTR) lpsz; // address 


K' Annotate 


Current annotation 


3 
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If you are planning to add a large number (more than - 

Save 

100) of strings by calling LB^ADDSTRING, 
LBJNSERTSTRING, LB_DIR, or LB_ADDFILE, 

Cancel 


consider first sending the new Win32 message 

Delete 

LBJNITSTORAGE to give the listbox a chance to 


preallocate memory, thus speeding up the process. 

Copy | 


Paste | 
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driver that start the DMA. GoDMAO (the second function 
shown) is called first. This function calculates the number of 
pages (a page is 4Kb) of memory needed for DMA and calls 
IoAl 1 ocateAdapterChannel () to reserve use of the DMA chan¬ 


nel. One of the parameters to IoAl 1 ocateAdapterChannel () is 
the address of the AdapterControl () function (shown first in 
Figure 2). AdapterControl () is called when the DMA chan¬ 
nel is free and ready to be used. If no other process is using 


Figure 1 Allocating DMA memory 

/**************************************************** 

// Get AdapterObject using above deviceDescription. 

Initialize device description and set up DMA buffer. 

ext->AdapterObject - HalGetAdapter(&deviceDescription. 

***************************************************** j 

&(ext->MaximumMapRegisters)); 

int DMAA11ocateBuffer(PDEVICE OBJECT deviceObject) 

if(!ext->AdapterObject) 

{ 

DEVICE DESCRIPTION deviceDescription: 

return 0; 

PDEVICE_EXTENSION ext; 

// A Map Register corresponds to 4K of memory. 

// Make sure we don't use more than are available. 

ext - (PDEVICE_EXTENSION)deviceObject-) 

DeviceExtension; 

if(ext->MaximumMapRegisters*4096 < ext->BufLength) 
ext->BufLength - ext->MaximumMapRegisters * 4096; 

ext->BufLength - USERDMA_BUFFER_SIZE; 

// Allocate a buffer for the DMA data. According to 

ext->NumADChans - USERDMA NUM AD CHANS; 

// DDK, we can only do this while initializing driver. 

ext->BytesPerFullSample = ext->NumADChans * 2; 

ext->BufVirtualAddress - 

HalAl1ocateCommonBuffer(ext->AdapterObject, 

RtlZeroMemory(&deviceDescription. 

ext->BufLength, 

sizeof(deviceDescription)); 

&(ext->Logical Address). 
FALSE); 

deviceDescription.Version - 0; 

if(!(ext-)BufVirtualAddress)) 

deviceDescription.Master - FALSE; 
deviceDescription.ScatterGather - FALSE; 

return 0; 

deviceDescription.DemandMode - FALSE; 

// Map the buffer. 

deviceDescription.Autolnitialize - TRUE; 

ext->pmdl “ IoAl1ocateMdl(ext->BufVirtualAddress, 

deviceDescription.Dma32BitAddresses - FALSE; 

ext->BufLength, FALSE, FALSE, 0); 

deviceDescription.BusNumber - 0; 

if(!ext->pmdl) 

deviceDescription.DmaChannel - USERDMA CHANNEL; 

return 0; 

deviceDescription.InterfaceType - Isa; 

MmBui1dMdlForNonPagedPool(ext-)pmdl); 

deviceDescription.DmaWidth - Widthl6Bits; 

return 1; 

deviceDescription.DmaSpeed - Compatible; 

i 

deviceDescription.MaximumLength - ext->BufLength; 
deviceDescription.DmaPort - 0; 

/* End of File */ 


the DMA channel when GoDMAO calls 
IoAl locateAdapterChannel (), then 
AdapterControl () (my callback func¬ 
tion) gets called immediately. 
AdapterControl () first calls 
IoHapTransfer (), which initializes the 
system's 8237 DMA controller. It then 
calls StartADO (the implementation of 
that function for my particular board is 
supplied on the code disk) to initialize 
and start the DMA from the data acqui¬ 
sition board. 

Figure 3 shows the MapBufferO 
function, which maps the DMA buffer 
into the caller's address space. This 
step is necessary since NT is a protect¬ 
ed operating system, and applications 
cannot generally access system buffers. 
The mapping mechanism may look 
familiar if you have used the Win32 file 
and memory mapping services. In this 
case the "file" I am mapping is actually 
\device\PhysicalMemory, which pro¬ 
vides access to physical RAM. Passing 
-1 as the process handle to the 
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ZwMapVi ewOfSecti on() function causes the buffer to be 
mapped into the address space of the calling process. When 
the driver passes control back to the application, it is free to 
access the "live" DMA buffer via the buf field of USERDMA_INFO. 
When the application is done, it calls the STOP function, which 
stops DMA (unless another process is still using it) and 
unmaps the buffer. 


The CUR_OFFSET command may optionally be called by an 
application (via Devi celoControl ()) at any time while DMA is 
active; the driver function that handles this command 
(DHACurOf f set ()) is shown in Figure 4. It uses 
HalReadDmaCounterO to get the current byte offset of the DMA 
within the buffer. It does a simple calculation to convert this 
byte offset into a word offset at the start of a sample (that 


Figure 2 Starting the DMA transfer 

j ********************************************************** 

AdapterControlO to start the DMA. We generally follow 

AdapterControlO is a callback specified in the 

the "common buffer" style of DMA described in the DDK. 

IoAllocateAdapterChannelO call. It is responsible for 

********************************************************* j 

actually starting the DMA by calling IoMapTransfer() to 

NTSTATUS GoDMA(PDEVICE EXTENSION ext) 

initialize the system DMA hardware, then calling whatever 

f 

routine is necessary to start the A/D board. 

KIRQL oldlrql; 

**********************************************************/ 

UL0NG NumMapPages; 

I0_ALL0CATI0N_ACTI0N AdapterControl( 

NTSTATUS status; 

PDEVICE OBJECT deviceObject, 


PIRP Irp, PVOID MapRegisterBase, PVOID Context) 

// Make sure DMA length is multiple of sample size. 

t 

ext->DMALength /- ext->BytesPerFul 1 Sample; 

PDEVICE EXTENSION ext; 

ext->DMALength *- ext->BytesPerFulISample; 

PHYSICAL ADDRESS phys; 



oldlrql = 255; 

ext - (PDEVICE EXTENSION) 

1f(KeGetCurrentIrql() < DISPATCH_LEVEL) 

deviceObject->DeviceExtensi on; 

KeRaiselrql(DISPATCH_LEVEL, &oldIrql); 

ext->MapRegisterBase - MapRegisterBase; 


phys - IoMapT ransfer(ext->AdapterObj ect. ext->pmdl, 

NumMapPages - ADDRESS_AND_SIZE_TO_SPAN_PAGES( 

MapRegisterBase, 

ext->BufVirtualAddress, ext->BufLength); 

ext->BufVirtualAddress, 


&(ext->DMALength), FALSE); 

status - IoAllocateAdapterChannel(ext-)AdapterObject, 

StartADO; 

ext->deviceObject, NumMapPages, 

return KeepObject; 

AdapterControl, 0); 

i 

if(oldlrql !- 255) 


KeLowerIrql(oldlrql); 

/********************************************************** 

return status; 

GoDMAO allocates the system DMA channel and, through 

i 

IoAl1ocateAdapterChannel(), calls 

/* End of File */ 
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means that the offset will always be a multiple of 16, since the 
board has 16 channels). The word offset is returned in the 
CurDMAWord field of the USERDMA_INFO structure. This gives an 
index into the DMA buffer of the most recent sample that has 
all of its channels scanned into memory. 

More than one process may be using the USERDMA driver 
at the same time. The driver keeps track of how many process¬ 


es have called its START command and keeps DMA going until 
the last process issues the STOP command. 

Simple Example Program 

I provide two example applications, dmaread.c (Listing 1) 
and dmasave.C (Listing 2), to exercise the device driver. Both 
are small, console-mode programs (no graphics; text only). 


Figure 3 Mapping the DMA buffer to user memory 


PVOID MapBuffertPVOID PhysAddrLow, ULONG Length) 

1 

UNICODE_STRING uniNameString; 

OBJECTj\TTRIBUTES attrib; 

HANDLE hPhysMem = 0; 

PVOID MemObject - 0; 

PHYSICAL_ADDRESS physicalAddress, viewBase; 

PVOID UserAddress - 0; 

physicalAddress.HighPart - 0; 
physicalAddress.LowPart - (ULONG)PhysAddrLow; 

RtlInitUnicodeStringf&uniNameString, 

L"\\Device\\Physical Memory"); 
InitializeObjectAttributes(&attrib, &uniNameString, 
0BJ_CASE_INSENSITIVE, (HANDLE) NULL, 
(PSECURITYJESCRIPTOR) NULL); 

1f(!NT_SUCCESS(ZwOpenSection(&hPhysMem, 

SECTION_ALL_ACCESS, &attrib))) 

return 0; 


if(!NT_SUCCESS(0bReference0bjectByHandle(hPhysMem, 

SECTI0N_ALL_ACCESS, (P0BJECTJYPE) NULL, 
KernelMode, MemObject, 
(P0BJECT_HANDLE_INFORMAT!ON) NULL))) 

goto close; 

viewBase - physicalAddress; 

if(!NT_SUCCESS(ZwMapViewOfSection(hPhysMem, (HANDLE) -1, 
^UserAddress, 0L, Length, SviewBase, 
&Length, ViewShare, 0, 

PAGE_READWRITE | PAGEJ0CACHE))) 

goto close; 

(ULONG)UserAddress +- (ULONG)physicalAddress.LowPart - 
(ULONG)viewBase.LowPart; 

close: 

ZwClose (hPhysMem); 

return UserAddress; 

1 

/* End of File */ 
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The nice thing about the NT console (like the Windows 95 con¬ 
sole) is that it lets you execute full-fledged WIN32 applications 
(not just DOS programs) without the overhead of a graphical 
environment, which is great for simple test programs. 

dmaread.C (Listing 1) sets the DMA buffer size to just one 
sample, then continuously displays the data values for the 
first eight A/D channels. The display loop calls the Sleep!) 
function so that the program does not unnecessarily hog the 
processor. The program starts by using the Win32 Created 
function to "open" the device driver. The special notation 
"\\.\" precedes the USERDMA name in the Created call. 
This tells the Created function that the name being given is 
for a device driver, not a regular disk file. Opening the 
USERDMA driver doesn't cause any real action other than 
acknowledging the open request. It simply allows the caller to 
get a handle to the driver. The handle is a required parameter 
of the DeviceloControl () function, which is called later in he 
program. 

Next, dmaread.C clears the dmainfo structure and sets the 
NumSamps field to 2. The program uses DeviceloControl () to 
call the device driver and pass it the dma info structure. The 
I OCTL_USERDMA_START command causes the driver to begin 
sending data to the buffer. 

Since the buffer is just one sample long, there is no need to 
keep track of the buffer position. I just read the most recent 
data out of the buffer. The for loop does just that, printing out 
the raw sample values from the first eight A/D channels. 
Notice that there are no calls to the device driver inside the for 


loop. The DMA hardware is continuously, automatically 
updating the buffer, with no help from the processor. 

This strategy is fine for simply monitoring sample values. 


Figure 4 Locating the current DMA offset 


NTSTATUS DMACurOffset(USERDMA_INFO *dmainfo, 
PDEVICE_EXTENSION ext) 


int Curlndex; 

Curlndex - ext->DMALength - 

HalReadDmaCounter(ext->AdapterObject); 

// Convert from bytes to full (all channels) samples. 
Curlndex /= ext->BytesPerFul1 Samp!e; 

// Get last completed full sample. 

--Curlndex; 

// Convert from sample number to byte offset. 

Curlndex *- ext->BytesPerFul1Sample; 

// If we go below the start of the buffer, take the 
// last sample in the buffer, 
if(Curlndex < 0) 

Curlndex - ext->DMALength - ext->BytesPerFul1Sample; 

// Convert from byte offset to word offset, 
dmainfo->CurOMAWord - Curlndex / 2; 

return STATUS_SUCCESS; 

1 

/* End of File */ 




TSv* 

sagu* 


J A 


ISSBa 


WinWidgets 3.0 

Intelligent Custom Controls 
for Windows 


t r~ 


J Lhoi 






“■•eiw 


WinWidgets is the definitive set of 
controls you need in your toolbox. For 
one low price you get a complete set 


of interface elements including a Grid and Spreadsheet, 
Tabbed Dialog, Spin Control, Masked Edit, Picture Button. 
Status Bar, Tool Bar, List Box, Combo Box, and much 
more. The power of WinWidgets will simplify your devel¬ 
opment efforts with features such as input validation, ODBC 
database connections, and powerful data handling. You can include WinWidgets controls 
with all popular Windows development tools including Visual Basic, Visual C++, and 
Borland’s Resource Workshop. WinWidgets supports both 16- and 32-bit environments to 
allow you to develop tomorrow’s applications today. 

WinWidgets/VBX 
WinWidgets++ 

WinWidgets/32 
WinWidgets Source Edition 




FEATURES: 

• From tab controls to spread¬ 
sheets, everything you need for 
interface design 

• Supports Windows 3.1, Win32s 
and NT with the same API 

• “Data-Aware” connections to MFC 
and the Visual Basic data control 

• Aesthetic 3-D look 

• Easily customized 

• Works with AppStudio, Resource 
Workshop, the NT Dialog Editor 
and VB versions 1.0-3.0 

• Includes C++ extensions to 
the MFC 


Call & Order Today 800*987*4929 

1163 Shrewsbury Ave • Shrewsbury NJ • 07702-4321 • (908) 389-0037 • Fax (908) 389-9227 • BBS (908) 389-9783 


LIFEBOAT 





□ Request Reader Service #109 □ 


March 1996 


Windows Developer’s Journal — Page 15 




























As long as the sample rate is higher than the display rate, the 
user will see a smoothly updated display. But if you need to 
process every sample, or save the data to disk, then a slightly 
more complicated program will be needed. 

An Example That Saves the Data 

dmasave. c (Listing 2) uses a larger buffer so that each sam¬ 
ple will be available individually. It also makes use of the 
IOCTL_USERDMA_CUR_OFFSET command to get the current DMA 
location. Getting the current DMA offset does not affect the 
DMA data collection at all. It simply returns the current loca¬ 
tion of the DMA operation within the buffer. The sample 
buffer is still "alive" and continues to be updated automati- 
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♦ File manager dynamically configured at 
runtime—no configuration file needed 
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♦ Use partial & duplicate keys; automatic 
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record locks, much much more... 
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cally, whether or not the IOCTL call is made. 

The main routine in dmasave . c (Listing 2) isn't much bigger 
than that of the simpler example. It starts out by opening an 
output file, where the samples will be stored. It opens the 
device driver and starts DMA. It checks that the DMA buffer 
size is large enough, since it is possible that another process 
has started the USERDMA driver with a small buffer. The 
main loop checks for user input, which is used to control the 
data saving and to quit the program. It also calls CheckSave(), 
which is responsible for writing out data samples to the out¬ 
put file, when necessary. The main loop then prints out the 
values from the first eight channels, and sleeps for 100 msec. 
When the user presses "q" to quit, the loop is exited, and the 
USERDMA device and output file are closed. 

In determining the amount of time 
to sleep, you need to consider the sam¬ 
ple rate and the buffer size. You must 
make sure that the sleep time is less 
than the time it takes the buffer to fill 
up. You should give a lot of leeway, 
since SleepO is not very accurate. For 
example, if the sample rate is 100Hz 
and the buffer is 1,000 samples long, 
then it will take 10 seconds for the 
buffer to fill. If you sleep more than 10 
seconds, you will lose data. If you sleep 
for 5 seconds, this will give a comfort¬ 
able room for error and slop in the 
scheduling. The example program 
saves half of the buffer at a time, even if 
CheckSaveO is called more than twice 
per buffer. This helps reduce disk activ¬ 
ity. 

Using the very simple "sleep-and- 
check" method lets you avoid the use of 
interrupts or separate threads to moni¬ 
tor the DMA progress. It is quick and 
easy, but may not be suitable for all 
applications. High-speed applications 
that would fill up the DMA buffer in 
less than a couple of seconds should 
probably use interrupts to help ensure 
that no data is lost. 
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Getting Loaded 

Loading drivers in NT is made very 
easy by the dynamic loading facility of 
NT's service manager. To learn how to 
use this, see Paula Tomlinson's 
"Dynamically Loading Drivers in 
Windows NT" (W/DD/ May, 95), or use 
the INSTDRV example that comes with 
the DDK. INSTDRV can be compiled 
as-is, without the kernel-mode example 
driver, and used to register and start 
any dynamically loadable driver. Then 
you can use "net stop userdma" and 
"net start userdma" to stop and start 
the driver. There should never be any 

March 1996 











reason to reboot (unless, of course, the driver crashes the sys¬ 
tem) or to manually edit the registry. 

Going Further 

Multiple processes/threads can access the driver. Multiple 
threads within a process may simply share the buffer, since 


the buffer pointer is good for any thread within a process. 
Each separate process, though, must open the driver itself, 
since the buffer pointer is only good for the process that 
makes the DeviceloControl () call. Try starting several console 

(Text continued on page 20. See page 18 for Listing 2.) 


Listing 1 dmaread.c — Simple app to sample DMA buffer 

((define WIN32 

if (! DeviceloControl(hUserDMA, 

((include <stdio.h> 

IOCTL USERDMA START, &dmainfo, sizeof(dmainfo), 

((include (windows.h> 

Mmainfo, sizeof(dmainfo), Snchar, 0)) { 

((include <winioctl.h> 

printf("Error doing I0CTL\n" ) ; 

((include (string.h) 

goto endit; 

((include "userdma.h" 

} 

wh11e(IkbhltO) { 

maintint argc, char *argv[] ) 

for ( i-0; i < min ( dmainfo.NumChans, 8); ++1 ) 

( 

printf ( ”%7d ", 

HANDLE hUserDMA; 

dmainfo.buf[dmainfo.CurDMAWord+i ]) : 

USERDMAJNFO dmainfo; 

printf ( "\r" ) ; // carriage return, no linefeed 

int i, nchar; 

Sleep(20); // don't be a processor hog 

} 

getchO; 

// Get handle to the USERDMA device driver. 

hUserDMA - CreateFileC'MW.Uuserdma", 

printf ( "\n" ); 

GENERIC READ, 0, NULL, OPEN EXISTING, 

endit: 

FILE_ATTRIBUTE_NORMAL, NULL); 

// Stop DMA. 

DeviceloControl(hUserDMA, 

if(hUserDMA — INVALID HANDLE VALUE) { 

IOCTL USERDMA STOP, &dmainfo, sizeof ( dmainfo ) , 

printfC'Couldn't access USERDMA device\n"); 

Jdmainfo, sizeof(dmainfo), &nchar, 0); 

return -1; 

// Release the device driver. 

} 

CloseHandle(hUserDMA); 

memsetUdmainfo, 0, sizeof ( dmainfo )) ; 

return 0; 

dmainfo.NumSamps - 1; 

1 

// Start up the DMA. 

/* End of File */ 
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Listing 2 dmasave.c — App to save DMA buffer data to disk 

♦define WIN32 

{ 

//include <std1 o.h> 

save from index - GetCurlndext ) ; 

//include (windows.h> 

iflsave fromjndex < BufSize/2) { 

//include <winioctl,h> 

saved_low_f 1 ag - 0; 

//include (string.h> 

saved_high_f1ag - 1; 

//include "userdma.h" 

} else { 

//define BUFSIZE.SAMPS 1000 

saved_low_f1ag - 1; 
saved_high_flag - 0; 

int saved low flag, // TRUE if low/high half of buffer 

) 

saved high flag: // has been written out to disk. 


int saving flag; // TRUE if we should be saving the 

/* Write the Buf [] entries from From to To inclusive. If 

.// data now. 

From > To. then wrap around at the end of the buffer. 

int save from index; // lowest sample to write out to 

This takes an index into the Buf [] array, which is an 

// the file 

array of SHORT integers (2 bytes). So the counts must be 

short *Buf; // pointer to sample buffer. 

multiplied by 2. */ 

int BufSize; > // size of buffer in 16 bit words 

void WriteBuf ( int From, int To) 

FILE *outfile; // Output file for data. 

{ 

HANDLE hUserOMA; II handle to USERDMA driver. 

if ( From < To) 

USERDMA INFO dmainfo; II DMA information structure. 

fwrite(&Buf[From], ( To-From+1)*2, 1, outfile); 

/* Call the device driver to get the current DMA pointer. */ 

else { 

fwrite(&Buf[From], (BufSize-From)*2, 1, outfile); 

int GetCurlndex(void) 

fwrite(&Buf[0], (To+l)*2, 1, outfile); 

int nchar; 

i 

DeviceloControl(hUserDMA, IOCTL USERDMA CUR OFFSET, 


&dmainfo. sizeof ( USERDMA INFO), 

1* This routine is called periodically to see if we need 

&dmainfo. sizeof(USERDMA INFO), 

to write out any data to the file. We write out half a 

&nchar, 0); 

buffer at a time. */ 

return dmainfo.CurDMAWord; 

void CheckSave(void) 

) 

/* If user requests that we start saving data, set up all 

int Curlndex; 

// Update dmainfo.CurDMAWord, and get current index 

of our data structures and go. */ 

Curlndex - GetCurlndexO; 

void StartSaving(void) 

if(!saving_f1ag) 
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windows and running a separate DMAREAD in each. They 
should all show the values from the live data buffer. 

If your board is not a National Instruments AT-MIO-16X, 
then you will need to create your own StartAOC) and StopAD() 
routines. There are comments in natinst.C (supplied on the 


code disk) that should provide some guidance. Basically, the 
StartADO routine must initialize the data acquisition board 
for continuous DMA, and set up the timers for the desired 
sample rate. You also need to verify whether your board sup¬ 
ports 8-bit or 16-bit DMA. As provided, the driver uses 16-bit 


Listing 2 continued 


return; 

if(saved_low_flag — 0 && Curlndex >- BufSize/2) ( 
saved_low_f1ag - 1; 
saved_high_flag - 0; 

WriteBuf(save_from_1ndex, BufSize/2-1); 
$ave_from_index - BufSize/2; 

} else if(saved_high_flag — 0 U 

Curlndex < BufSize/2) { 

saved_high_flag - 1; 
saved_low_flag - 0; 

WriteBuf(save_from_index, BufSize-1); 
save_from_index - 0; 



/* Write out the last data to the file. */ 
void StopSaving(void) 

( WriteBuf(save_from_index, GetCurlndexO); } 

/* Open file and start DMA. */ 
main(int argc, char *argv[]) 

( 

int nuuread, i, nchar; 
char FileName[50]; 
char ch; 


if(argc > 1) 

strncpy(Fi1eName, argv[l], sizeof(FileName)); 

else 

strcpyCFileName, "nul"); 

// Open the output data file, 
outfile - fopen(Fi1eName, "wb"); 
ifdoutfile) { 

printfC'Could not open file 'Is' for writing\n", 

Fi1eName); 

exit(-l); 

} 

// Get handle to device driver. 

hUserDMA - CreateFi1e<"\\\\.Wuserdma", GENERIC_READ, 

0, NULL, 0PEN_EXI STING, FILE_ATTRIBUTEJORMAL, NULL); 
ifChUserOMA — INVALID_HANDLE_VALUE) { 

printfC'Couldn't access USERDMA device\n"); 
return -1; 

} 

// Set our requested buffer size. 
dmainfo.NumSamps - BUFSIZE_SAMPS; 

// Start up the DMA. 

if( IDeviceloControl(hUserDMA, 

IOCTL_U$ERDMA_START, Mmainfo, sizeof(dmainfo), 
Sdmainfo, sizeof(dmainfo), &nchar, 0)) f 
printf("Error doing I0CTL\n”); 
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DMA. If your card does not support 16-bit DMA, then you 
should change the DmaWidth setting in the deviceDescription 
structure, which is initialized inside DMAA1 locateBuffer( ) (see 
Figure 1). For simplicity, I have hard-coded some of the pro¬ 
gram parameters with (/defines. In a non-example driver, any 
configurable parameters would go into the registry. 

The nice thing about a simple driver example is that there 
is a lot of room for improvement! You might want to experi¬ 
ment with interrupts, or with using a separate thread in the 
application to monitor the DMA progress. Of course, this dri¬ 


ver is crying out for a graphical display of some sort to pro¬ 
vide a more friendly interface to the user. Those porting dri¬ 
vers and low-level applications from DOS and Windows are 
used to having more direct control of the system. This exam¬ 
ple should demonstrate that it is quite easy to learn and use 
the higher-level interface used in writing device drivers for 
Windows NT. The extra time that it takes to become comfort¬ 
able with the NT DDK will be more than made up for by the 
resulting robust, flexible device drivers. □ 


Listing 2 continued 

goto endit; 

break; 

// If another process has already started DMA with 

CheckSaveO; 

// a small buffer, quit. 

printf ( "%7s ", saving_f 1 ag ? "SAVING" : ""); 

if(dmainfo.NumSamps < BUFSIZE SAMPS) { 

for(i— 0 : i <8; ++1 ) 

printf ( 

pri ntf (" J>7d”, Buf [dmai nfo. CurDMAWord+i ] ); 

"USERDMA already started with small buffer.\n"): 

printf("\r"); 

goto endit; 


1 

// don't hog the processor 

BufSize - dmainfo.NumSamps * dmainfo.NumChans; 

SleepdOO); 

Buf - dmainfo.buf; 

} 

printf ( "Press SPACE to toggle saving; ' q ’ to quit.\n"); 

printf("\n"); 

whiled) { 


if(kbhitO) { 

endit; II Stop DMA. 

ch - getchO; 

DeviceloControl (htlserDMA, IOCTL USERDMA STOP, Sdmainfo, 

1 f ( ch — ’ ') { 

sizeof(dmainfo), &dmainfo, sizeof(dmainfo),&nchar,0); 

saving flag 1; 

CloseHandle(hUserDMA); 

iftsaving flag) 

fclose(outfile); 

StartSavingO; 

return 0; 

else 

1 

StopSaving () ; 

/* End of File */ 

} else 1 f(ch -- ’ q ') 
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A VxD to Monitor Hardware 
Interrupts 


Jean-Frangois Larvoire 



Visual C++ v2.x 
Windows 95 DDK 


In the days of real-mode DOS, you could intercept hardware interrupts just by 
storing the address of your own interrupt handler in the appropriate slot of the inter¬ 
rupt vector at address 0. Under Windows 95, life is more complicated: multiple vir¬ 
tual 8086 machines may be running at the same time, and instead of the simple real¬ 
mode interrupt vector, interrupts get routed via a protected-mode Interrupt 
Descriptor Table (IDT). But if you're willing to write a VxD, the operating system 
provides services that seem capable of achieving the same effect. In practice, though, 
the documented services don't always provide the functionality you need. This arti¬ 
cle describes the undocumented behavior I ran into when I tried to directly intercept 
hardware interrupts under Windows 95. The code disk (see Table of Contents for 
availability) includes the VxD I finally arrived at that accomplishes this task. 

Introduction 

In order to debug a problem we had under Windows 95,1 needed a way to trace 
the hardware interrupts that occurred. My idea was to develop a small VxD that 
would intercept all IRQs at VMM (Virtual Machine Manager) level, and send a char¬ 
acter identifying each IRQ to a terminal connected to a serial port. Microsoft's DDK 
documents many services that the VMM and the system device drivers provide for 
VxDs, including services that help you intercept hardware interrupts. Unfortunately, 
the DDK documentation is not sufficient to understand the possibilities and limita¬ 
tions of these services. With the help of Microsoft support, I managed to gather more 
information on them. 

I'll first describe the Windows services that seemed most appropriate for my 
problem. Then I'll explain what I had to do to monitor IRQs successfully, and what 
this teaches about how Windows works. 

VPICD's VPICD_Call_When_Hw_Int 

VPICD is the Programmable Interrupt Controller (PIC) virtual device driver. 
VxDs are expected to make calls to VPICD rather than program the PIC directly, so 
that it can arbitrate conflicting requests from different programs. One likely looking 
service that VPICD offers is called VPICD_Cal l_When_Hw_Int. VPICD.Cal l_When_Hw_Int 


Jean-Frangois Larvoire has been developing BIOS and device drivers for Hp Vectras for 
the past six years. The opinions expressed in this article are his alone and do not neces¬ 
sarily reflect the opinions of Hewlett-Packard. Send questions or correspondence to Jean- 
Frangois via the Internet at larvoire@hp6300.desk.hp.com. 
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Listing 1 irqmon.h — Header file for VxD 


(/define IRQM0N_VERSI0N 0x100 // Version 1.00 

extern DWORD 01d_IDT_IRQs[NIDT][16]; // Previous handlers 

typedef unsigned char BYTE; 

(/define HANDLER SIZE 11 // Offset between IRQ handlers 

typedef unsigned short WORD; 


typedef unsigned long DWORD; 

extern DWORD dwIrqMask; // Bit n - 1 — > Intercept IRQ n 

(/pragma pack(l) 

extern void My_IRQ_Handler(void); 
extern int cdecl VPICD Hook IRQs(void); 

typedef struct 

extern int cdecl VPICD Unhook IRQs(void); 

{ 

extern PCALLGATEDESCRIPTOR GetIdtBaseCvoid ) ; 

WORD Offset 0 15; // Entry point's offset, lower 16 


WORD Selector; // Entry point's selector 

// In ComPort.asm 

BYTE DWord Count; // (O)Word parameter count 


BYTE Access Rights; // Present, dpi, system, type 

extern DWORD dwPort; // Serial port base I/O port 

WORD Offset 16 31; // Entry point's offset, upper 16 


) CALLGATEDESCRIPTOR,* PCALLGATEDESCRIPTOR; 

extern int _cdecl Init_UART(void); 
extern int cdecl Reset UART(void); 

(/pragma packO 



extern void cdecl SendChar(void); 

/* Prototypes */ 

(/define SENDCHAR(c) \ 

( ( asm mov al, c); SendCharO; ) 

// In IrqMon.c 

extern void cdecl SendNibble(void); 

(/define SENDNIBBLE(x) \ 

extern void Add IDT(PCALLGATEDESCRIPTOR); 

[ ( asm mov al, BYTE ptr x); SendNibble( ) ; } 

extern void Remove IDT(PCALLGATEDESCRIPTOR); 

extern void cdecl SendAL(void); 

extern DWORD stdcall IRQMON Dynamic Inittvoid); 

(/define SENDAL(x) \ 

extern DWORD stdcall IRQMON Dynamic_Exit ( void ) ; 

( Lasm mov al, BYTE ptr x); SendALt); } 

extern DWORD stdcall IRQMON Begin PM App( 

extern void cdecl SendAX(void) ; 

struct pmcb s *pPMCB, DWORD dwFlags); 

(/define SENDAX(x) \ 

extern DWORD stdcall IRQMON End PM App{ 

( {_asm mov ax, WORD ptr x}; SendAXO; ) 

struct pmcb_s *pPMCB); 

extern void cdecl SendEAX(void); 

(/define SENDEAX(x) \ 

// In HookIrq.asm 

{ { asm mov eax, DWORD ptr x); SendEAXO; } 

/* End of File */ 

(/define NIDT 5 // Number of IDTs supported 
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is an asynchronous service that allows a VxD to be notified 
whenever any (and every) hardware interrupt occurs. 
VPICD_Call_When_Hw_Int places the address of your callback in 
VPICD_Hw_Int_Fi 1 ter and returns the previous address to you. 
In other words, the last VxD to call the service is the one that 
receives the notifications, and it has the responsibility of pass¬ 
ing the notification on to the previous intercept routine. 

You can call this service again, with the address of the pre¬ 
vious callback function, to unhook your VxD from the chain, 
but this won't work if some other VxD called this service after 
yours did. Thus, your VxD may need to stay resident if it can¬ 
not unhook itself successfully. 

The callback routine installed by the 
VPICD_Cal l_When_Hw_Int service is responsible for chaining to 
the next handler in the interrupt filter 
chain. It must preserve the EBX register 
for the next handler. Here's a sample of 
what such a callback routine might look 
like: 

Sample_Hook_Ini t: 
pushfd 

cli ; interrupts MUST be disabled 
mov esi.0FFSET32 My_VPICD_Hw_Int_Fi1 ter 
VxDCall VPICD_Call_When_Hw_Int 
mov 

[Previous_VPICD_Hw_Int_Fi 1 ter],esi 
popfd ; restores interrupt flag 
ret 

My_VPICD_Hw_Int_Fi 1 ter: 

push ebx ; MUST save ebx 
; Do something useful 
pop ebx 

jmp [Previous_VPICD_Hw_Int_Fi1 ter] 


Note that the hardware interrupt has 
already been processed when the call¬ 
back routine is invoked — you should 
not therefore attempt to acknowledge 
the hardware interrupt yourself. Also, 
though the interrupt routine gets called 
for all hardware interrupts (which can 
severely retard system performance if 
you don't keep your callback very sim¬ 
ple), it does not receive any information 
that would identify which hardware 
interrupt it is currently being notified 
of. For this reason, the practical uses of 
this service are very limited. The Virtual 
DMA Device (VDMAD) does use it to 
detect when a DMA transfer is com¬ 
plete. The callback routine enables 
VDMAD to check the DMA controller 
in a timely manner without using one 
of the global timeouts. 

VPICD's 

VPICD_Virtualize_IRQ 

A VxD that interacts with a hard¬ 
ware device with hardware interrupts 
involved will achieve greatest respon¬ 
siveness (lowest interrupt latency) and 


finest level of control with VPICD_V i rtual ize_IRQ. 
VPICD_Vi rtual i ze_IRQ is a synchronous service used to gain 
access to a specific hardware interrupt. It is intended for VxDs 
that want to process an IRQ themselves, instead of letting 
Windows reflect the IRQ into a virtual machine, as is done by 
default. 

Unvirtualized IRQs are either global or owned. Global 
IRQs are those that were unmasked before Windows started. 
By default, Windows reflects them into the current virtual 
machine. Owned IRQs are those unmasked within a virtual 
machine after Windows started. Windows reflects them into 
the owning virtual machine. 

VPICDJ/i rtual i ze_I RQ requires a pointer to 
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Listing 2 

monitor VxD 


irqmon.c — Main C source for 


//define WANTVXDWRAPS 

//include <basedef.h> 

//include <vmm.h> 

//include <vxdwraps.h> 

//include "IrqMon.h" // Global constants for this program 
// Manipulate words. 

// Can be used both as an RVALUE and an LVALUE. 

//define WORDO(dw) (*((WORD *)(&(dw))+0)) 

//define WORDl(dw) (*((WORD *)(&(dw))+l)) 

/* Segmentation */ 

//pragma VxD_LOCKED_CODE_SEG 
//pragma VxD_LOCKED_DATA_SEG 

/* Global variables */ 

int nldt - 0; // Number of IDTs located so far 

PCALLGATEDESCRIPTOR pidtList[NI DTD; // Addresses of the IDTs 

PCALLGATEDESCRIPTOR pAbandonedldt - NULL; // IDT about to go 

/* given base of IDT, add it to our list */ 
void Add_IDTl(PCALLGATEDESCRIPTOR pldt) 

{ 

int i; 

int ilstFr; /* Index of first free IDT pointer */ 

/* If closing a PM app, don't add its IDT back. */ 
if (pldt == pAbandonedldt) return; 
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VPICD_IRQ_Descri ptor structure, which defines to what extent 
the IRQ is virtualized. Only the VID_Hw_Int_proc field of that 
structure requires a valid pointer to a callback in the VxD. The 
other callbacks (all V I D_????_proc fields) are only necessary if 
the VxD wants to reflect the IRQ into a virtual machine. 


VP ICD_IRQ_Descriptor STRUC 

VID_IRQ_Number dw ? 

VID_0ptions dw 0 

VID_Hw_Int_Proc dd ? 

VID_Virt_Int_Proc dd 0 

VID_EOI_Proc dd 0 

VID_Mask_Change_Proc dd 0 

VID_IRET_Proc dd 0 

VI D_I RET_T i me_0ut dd 500 

VI D_Hw_Int_Ref dd ? 

VPICD_IRQ_Descri ptor ENDS 


Your VID_Hw_Int_Proc is called by VPICD when the requested 
IRQ occurs. The VID_Hw_Int_Proc is well documented in the 
DDK, although its name is misleading, in that it seems to be 
related to the service VPICD_Call_When_Hw_Int, when in fact it 
is related to the service VPI C D_V i rtual i ze_I RQ. 

VPICDJ/i rtual i ze_IRQ allows up to 32 VxDs to share a par¬ 
ticular IRQ, and in Win95 a dynamic VxD can unvirtualize the 
IRQ if all of the VxDs have virtualized the IRQ with 
VP I CD_OPT_CAN_SHARE. With VPICD_OPT_CAN_SHARE, the VxD's 
callback procedure, VI D_Hw_I nt_Proc will return with the carry 
flag clear if it handles the interrupt and acknowledges it 
(sends an EOI command to the interrupt controller). VPICD 
stops calling the registered interrupt procedures in the list 
after the first callback returns with the carry flag clear. The 
callback procedures are called in the order in which they vir¬ 
tualized the IRQ. This means that the first VxD to virtualize 
the IRQ gets called first. If a callback's target hardware is not 
responsible for the IRQ, then the callback should restore the 
entire register set to the state of entry and return with carry 
set. VPICD will call the next callback in the list if the current 
callback returns with carry set. The last callback in the list is 
the Default Shared IRQ Flandler which will EOI the PIC and 
"reflect" the interrupt into the current Virtual Machine. (See 
stdvxd.doc in the Windows 95 DDK for more information on 
VPICD_Vi rtual ize_IRQ in Win95.) 

Get_PM_Int_Vector and Set_PM_Int_Vector 

The VMM offers services called Get_PM_Int_Vector and 
Set_PM_IntJ/ector. These two functions do not apply to the 
physical interrupts at VxD ring 0, but only to the simulated 
interrupts at ring 3. They are useful for responding to software 
interrupts in virtual machines. You must allocate a PM call¬ 
back with the VMM service Allocate_PM_Call_Back before 
passing that address to Set_PM_Int_Vector. 

The address returned by Get_PM_I nt_Vector is that of the 
previous ring 3 callback, or that of the default Windows han¬ 
dler. It is not the address of the ring 0 physical hardware inter¬ 
rupt handler located in the protected-mode Interrupt 
Descriptor Table (IDT). 

The PM callback gets control when an interrupt is simulat¬ 
ed. It can either chain to the previous callback, by doing a 
VMM jmp to Si mul ate_Fa r_Jmp, or it can return from the interrupt 
immediately, by doing a VMM jmp to Si mul ate_I ret. Any other 
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way of returning would cause an infinite loop with the call¬ 
back invoked repeatedly, since the ring 3 registers would still 
point to the I NT 30H instruction used to switch from ring 3 to 
ring 0. 

Directly Modifying the IDT 

VPICD_Call_When_Hw_Int was not usable for my problem 
because the callback is called after the interrupt is acknowl¬ 
edged, and there is no way to identify the IRQ. Windows pass¬ 
es no handle as it does for VPICD_V i rtual i ze_IRQ, and the 
interrupt controller In-Service Register (ISR) is cleared by the 
acknowledgment. 

VPICD_V i rtual i ze_IRQ was not usable either, because other 
VxDs already hook the service and get a chance to acknowl¬ 


edge the interrupt first. The VxDs also may not have the 
V PI CD_OPT_CAN_SHARE option. So it's not possible to guarantee 
your code will receive control on all IRQs. Since neither of the 
two VPICD services was suitable for my goal, I decided to do 
it the dirty way, and hook the IRQs directly in the protected 
mode IDT. 

In the 80x86 protected mode, the good old DOS interrupt 
vectors are replaced by an Interrupt Descriptor Table (IDT). 
Instead of an array of simple 32-bit addresses, this table con¬ 
tains protected-mode descriptors, each one eight bytes long. 
Rather than residing at address 0 (like the real-mode interrupt 
vector), the IDT can be located anywhere in memory; a special 
instruction (SIDT) retrieves its current address. 

There are several types of descriptors that might reside in 
the IDT, but under the Windows Virtual 
Machine Manager, all IRQs are gates to 32-bit 
ring 0 code segments. Hooking an interrupt is 
as simple as replacing the 32-bit offset in a 
gate with your own. 

typedef struct 

{ 

// Entry point’s offset, lower 16 bits 
WORD Offset_0_15; 

// Entry point’s selector 
WORD Selector; 

// parameter count. 0 for IRQ handlers. 
BYTE DWord_Count; 

// Present, dpi, system, type 
BYTE Access_Rights; 

// Entry point’s offset, upper 16 bits 
WORD Offset_16_31: 

} CALLGATEDESCRIPTOR,* PCALLGATEDESCRIPTOR; 

There is a small catch: Windows reprograms 
the 8259 interrupt controllers so that IRQO to 
IRQ15 generate interrupts 0x50 to 0x5F. This is 
different from DOS, where by default IRQO to 
IRQ7 map to interrupt 0x08 to 0x0F, and IRQ8 
to IRQ15 map to interrupt 0x70 to 0x77. The 
reason for this is that in protected mode the 
Intel processors generate exceptions in the 
interrupt 8 to 15 range. The designers of the 
original IBM PC obviously did not notice that 
Intel had reserved all interrupts from 0x00 to 
0x1 F for future processors. 

The first version of my VxD had 16 small 
interrupt handlers, each one outputting a spe¬ 
cific character and chaining to the previous 
handler. My VxD dynamic initialization 
would get the IDT address with the privi¬ 
leged SIDT instruction, replace the interrupt 
0x50 to 0x5F descriptor offsets with those of 
my interrupt handlers, and then store the pre¬ 
vious handler address in an array for later use 
by the local handlers. It was simple, it looked 
good, but it did not work! 

I expected a continuous stream of IRQOs to 
show up on the monitor. The 8254 timer 0 
generates an IRQO 18.2 times per second. This 
IRQO is used to update the operating system 
time. It is also used by preemptive multitask- 
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Listing 2 continued 


pAbandonedldt = NULL; /* Forget the abandonned IDT. */ 

for (1=0, ilstFr - nldt; i<nIdt; 1++) 

{ 

if (pldt -- pldtList[i]) return; /* Known IDT */ 

if ((ilstFr > i) && (!pldtList[i])) ilstFr - i; 

} 

SENDCHAR('J'); 

SENDEAX(pIdt); /* Display the new IDT base */ 

if (ilstFr — NIDT) return; /* Prevent tbl overflow */ 

pldtList[iIstFr] - pldt; /* Record the IDT address */ 

/* Intercept the requested IRQs directly in the IDT */ 
for (i=0; i<16; 1++) if (dwIrqMask & (1 « i)) 

{ 

DWORD dw; 

int ix - 0x50+i; I* IRQ handler index in an IDT */ 
SENDCHARC-'); 

SENDNIBBLE(i); /* Display the IRQ being hooked */ 

W0RD0(01d_IDT_IRQs[ilstFr][i]) = pldt[ix].Offset_0_15; 
W0RD1(01d_IDT_IRQs[iIstFr][i]) - pldt[ix].0ffset_16_31; 

SENDCHARC-’); 

dw - 01d_IDT_IRQs[iIstFr][1]; 

SENDEAX(dw); /* Display the old handler */ 

dw - (DW0RD)My_IRQ_Handler+(HANDLER_SIZE*((ilstFr*16)+i)); 


SENDCHARC); 

SENDEAX(dw); /* Display the new handler */ 

pldt[0x50+1].0ffset_0_15 - WORDO(dw); 
pldt[0x50+i].0ffset_16jl - WORDl(dw); 

} 

if (ilstFr ™ nldt) nldt +- 1; 
return; 

} 

void AddJDT(PCALLGATEDESCRIPTOR pldt) 

{ 

_asm pushfd 

_asm cli /* Begin critical section */ 

AddJDTl(pIdt); 

_asm popfd /* End critical section */ 

} 

/* given base of IDT, remove it from our list */ 
void Remove_IDT(PCALLGATEDESCRIPTOR pldt) 

{ 

int i, j; 

_asm pushfd; 

_asm cli; /* Begin critical section */ 

for (i-0; i<nIdt; 1++) /* Find the IDT in our list */ 

{ 

if (pldt — pldtList[i]) /* If found, remove it */ 

{ 
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ing operating systems such as Virtual Machine Manager to disk accesses, I observed no interrupt at all. Also, when I 
force task switches. Instead, I observed sporadic bursts of pressed a key on the keyboard, I usually saw only one IRQ1, 
interrupts. And when the system was very busy, doing heavy instead of the two that are always generated (one for the key 


Listing 2 continued 

SENDCHARC '$’); 

SENDEAX(pIdt); 

1 

asm popfd; /* End critical section */ 

/* Restore the IDT handler addresses */ 
for ( j=0 ; j < 16; j++) if (dwIrqMask & (1 « j )> 

return; 

l 

int ix - 0x50+j; 


DWORD dw; 

/* called once after VxD is loaded */ 

DWORD stdcall IRQMON Dynamic Init(void) 

SENDCHARC-'); 

1 

SENDNIBBLE(j); 

InitJJARTO; /* Prepare the UART for output */ 

VPICD Hook IRQsO; /* Hook IRQs using the VPICD service */ 

SENDCHARC-'); 

WORDO(dw) - pldtlix],Offset 0 15; 

return(VXD SUCCESS); 

WORDl(dw) - pldtlix],Offset 16 31; 

1 

SENDEAX ( dw ) ; 

/* called once before the VxD is unloaded */ 

dw - Old IDT IRQs[i ][j]; 

DWORD stdcall IRQMON Dynamic Exit(void) 

pldtlix],Offset 0 15 - WORDO(dw); 

1 

pldtlix].0ffset_16_31 - WORDl(dw); 

int i; 

PCALLGATEDESCRIPTOR pldt; 

SENDCHARC '+'); 

SENDEAX(dw); 

_asm pushfd; 

1 

_asm cli; /* Begin critical section */ 

/* And free the entry */ 
pldtListli] - NULL; 

VPICD_Unhook_IRQs () ; /* Unhook IRQs from VPICD */ 

1 

for ( i—0 ; iCnldt; i++) /* Unhook all IROs in all IDTs */ 
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press and one for the key release). Sometimes, no IRQ1 was 
even traced, even though the key was processed correctly by 
Windows. After carefully making sure this was not a problem 
with the VxD itself, such as an overflow in the serial port 
Transmit Holding Register, I had to conclude that the only 
possible explanation is that Windows has more than one IDT! 

I looked into the various books I have about undocument¬ 
ed aspects of Windows and Windows 95, but no one seemed 
to be aware of this fact. So I turned to Microsoft support, and 
got this exciting answer: "Yes, there is more than one IDT . . . 
but this topic is verboten." 

Why Windows Has Several IDTs 

Okay, Microsoft wouldn't help, but that wasn't enough to 
stop me — to the contrary, in fact! I updated my IRQ monitor 
(IRQMON) to use the VPICD_Ca 1 l_When_Hw_Int service, to gain 
control on every hardware interrupt. It then tested the current 
IDT base against an array of known values. If the value was 
not known, I added it to the array and dumped it on the seri¬ 
al terminal. This worked well, and revealed that there were 
two IDTs. I updated the program to hook interrupts in the sec¬ 
ond IDT too. This time, a smooth flow of IRQOs showed up on 
the monitor. At this point I thought the two IDTs were just an 
additional undocumented feature that we had to accept as is, 
without attempting to find a reason for it. My revised IRQ 
monitor worked well for several days, until a third IDT 
showed up! I hooked the IRQs there too. Then the PC crashed 
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Listing 2 continued 


t 

if (pldtList[1]) Remove_IDT(pIdtList[i]); 

1 

ResetJJARTO; /* Minimal cleanup */ 

_asm popfd; /* End critical section */ 

return(VXD_SUCCESS): 

1 

/* Called when a protected-mode app starts */ 

DWORD _stdcall IRQMON_Begin_PM_App(struct pmcb_s *pPMCB, 

DWORD dwFlags) 

1 

Add_IDT(GetIdtBaset)); /* Add the new IDT to our list */ 

return VXD.SUCCESS; 

1 

/* called when a protected-mode app ends */ 

DWORD _stdcall IRQMON_End_PM_App(struct pmcb_s *pPMCB) 

{ 

/* Remove the IDT from the list, and make sure it is not 
added back, should it be used for a few more ints. */ 
pAbandonedldt = GetldtBaseO; 

Remove_IDT(pAbandonedIdt): /* Remove it from the list */ 

return VXDJUCCESS; 

1 

/* End of File */ 
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when I unloaded the VxD after the tests. It complained that I 
had attempted to write to an unmapped area of memory. 

Now things were becoming more complex, since IDTs 
seemed to be created and destroyed dynamically. I was start¬ 
ing to lose patience, but then I realized that when that third 
IDT unexpectedly appeared, I was running a protected-mode 
DOS program for the first time. Obviously, Windows had cre¬ 
ated the third IDT when this DOS program started, and 
destroyed it afterwards. Immediately things became clear: the 
VMM has one IDT for virtualizing virtual 8086 machines. 
There's no risk that virtual 86 applications will break anything 
in the VMM. But protected-mode DOS applications can cause 
a lot of damage if they access the IDT as I did. So the VMM 
tries to protect its main IDT by cloning it every time a protect¬ 
ed-mode DOS application starts and 
using only the clone IDT for the virtual 
machine with the protected-mode 
application. This way, if the protected- 
mode DOS application modifies its own 
IDT, Windows' IDT is still intact and the 
other virtual machines should not be 
much affected. 

This also explains why there were 
two IDTs to begin with: Windows (the 
graphical user interface) is simply a 
protected-mode DOS application run¬ 
ning in the system virtual machine. So 
VMM clones an IDT for it too. QED. 

The last tweak to make my VxD 
work reliably was then relatively easy. 

The VMM broadcasts BEGIN_PM_APP and 
END_PM_APP messages to all VxDs when 
protected-mode DOS applications 
begin and end, respectively. For the first 
time I could see a use for these mes¬ 
sages. I changed my VxD to add and 
remove IDTs from its list dynamically 
when it gets these messages. There is a 
minor problem because a few more 
interrupts may still be processed with 
the soon-to-be-deleted IDT even after 
the END_PM_APP message. They must be 
ignored by the VPICD_Cal l_When_Hw_Int 
callback, otherwise I would still have 
the eventual crash when the VxD is 
unloaded. This causes a few IRQs to be 
missed on the terminal screen. 

Symmetrically, a few IRQs may also be 
missed when a protected-mode DOS 
application first starts. 

Source Code 

The complete source code for the 
VxD, including code to send characters 
to the serial port, is on the code disk 
(see the Table of Contents for availabili¬ 
ty). i rqmon. h (Listing 1) contains header 
definitions, while i rqmon. c (Listing 2) 
contains much of the C source, includ¬ 


ing the code to manage the list of current IDTs. hookirq.asnt 
(Listing 3) contains the assembly language portion of the VxD 
that includes the hook routines for the hardware interrupts. 
The code disk includes a batch file to help you rebuild the 
VxD, but you will need the Windows 95 DDK. 

The code disk also contains a small DOS program that uses 
the VxD loader v86 API to dynamically load and unload my 
VxD. This works under both Windows 3.11 and Windows 95, 
but not under Windows 3.1. Under Windows 3.11, it is neces¬ 
sary to have vxdl dr .386 loaded in the [386ENH] section of sys¬ 
tem, ini, by a "device=VXDLDR.386" line. Under Windows 
95, vxdl dr. vxd is included in vmm32. vxd, and is always loaded. 


Unique New Technology Guarantees Unequaled 
Benefits for Windows" and NetWare® Programmers! 



Compress your Windows 
.EXEs and .DLLs with 
Blinker" 4.0! 

Compress your 
^ Windows, DOS 

and DOS extended 
.EXEs and .DLLs by 
•f 50% or more with 
/ Blinker 4.0! No 
Jr. other product 
offers you this 
benefit, which mini¬ 
mizes your distribution costs, 
reduces network traffic and 
protects your programs from 
being decompiled! Your 
compressed .EXEs & DLLs 
will execute direcdy, with no 
separate decompression step! 

Blinker 4.0 also introduces fast 
linking of 32 bit PE format 
Windows EXEs for Windows NT 
and Windows 95, plus the ability 
to create .DLLs for DOS extended 


Blinker feature checklist: 

• unique ability to compress 
Windows and DOS extended 
.EXEs and .DLLs by 50% or more 

• Windows and DOS hosted linker also 
creates DLLs in DOS extended programs 

• fastest available 1 6 & 32 bit Windows linker 

• DOS extender to directly access up to 16Mb of 
memory, fully compatible with DPMI, VCPI and 
XMS programming standards and featuring a 
comprehensive API 

• dynamic overlay linker to overcome the 640Kb 
conventional memory limit featuring EMS/XMS 
overlay caching for optimum execution speed 

• unique dual mode feature to run the same .EXE 
automatically in either real or protected mode 

• no runtime royalties 

• a memory efficient super 'SPAWN" command to 
run large programs, such as a word processor or 
a report generator, from inside your main program 
with less than a 10Kb memory overhead 

• Microsoft C/C++, FORTRAN, Pascal, Assembler, 
Borland C/C++, Assembler, Symantec C++, 

Watcom C/C++ and CA-Clipper support 

• full support for CodeView. Soft-ICE and 
Periscope debuggers 

• serial number encryption 

• creation of demonstration versions 

• over 500 pages of documentation and complete 
on-line help in a Windows .HLP file 


programs, so you can share code 
and data between applications 
and easily update parts of your 
program. 

Proven Results! 




I MitroM.fl C++ CATALOG.EXE 
example program linked with 
MSLINK 


□ Microsoft C++ CATALOG.EXE 
linked with Blinker's compression 


.EXE and .DLL compression 

The fastest Windows & DOS 
linker and a royalty-free 
DOS extender!! 

Compatible with C, C++, Pascal, 
FORTRAN, CA-Clipper and ASM, 
Blinker 4.0 is a royalty-free DOS 
extender, the worid s fastest 
Windows linker and an award¬ 
winning dynamic overlay linker, 
all in one unique product for 
one low price! Virtually elimi¬ 
nate programming “down time” 
with the fastest link times for 
Windows, DOS-extended and 
DOS programs. 

Call today to see why over 
60,000 programmers are 
already using this award¬ 
winning product! 





The world's first network 
library for Visual Basic, 
Delphi, 

C/C ++ and 
CA-VOH 



Make your 
Visual Basic, 

Delphi, 

C/C++, CA-VO and 
CA-Clipper programs 
NetWare-aware the 
easy way, with the latest 
version of this award¬ 
winning network library’. 
NOVLIB 3 0 features over 
450 functions, written in 
highly optimized C and 
ASM code, for printing, 
security, mapping, 
messaging, IPX/SPX 
handling, accounting 
and much more and is 
the only network library 
which brings the power 
of Novell to Windows, 
DOS extended and real 
mode DOS programs 
for all these languages. 

If you program for Novell 
networks, you need 
NOVLIB! Call Blinkmc 
today for your free sample 
program! 


s Save $50! ■ 

Blinker 4.Q $249 
NQVUB 3.0 $249 

TEL: 1-804-747-6700 
FAX: 1-804-747-4200 

o. 


Blinkmc 

8001 W. Brood Si., Richmond YA 23294 
In Europe contort: Btotkinf Ltd. 

TEL+44 1222 712444 • FAX:+44 1222 700888 


Graphics copyright Blink. Inc 1995. Blinker and NOVLIB are trademarks of ASM, Inc. All other trademarks acknowledged. 


□ Request Reader Service #128 □ 

Windows Developer’s Journal — Page 33 



March 1996 

















Listing 3 hookirq.asm — Callbacks for IRQ 
monitor VxD 


page ,132 

. 386p 

WIN31C0MPAT equ 1 

.xlist 

include vmm.i'nc ; Virtual Machine Manager defs 
include vpicd.inc ; Virtual Interrupt Controllers defs 
.list 

include irqmon.inc ; Converted from IRQMON.H 
option casemap:notpublic ; Broken by H2INC 

N_HANDLERS equ NIDT * 16 ; Number of IRQ handlers 

VxD_LOCKED_DATA_SEG 

public dwIrqMask 

dwIrqMask dd OFFFFH : Bit n = 1 —> Intercept IRQ n 

next_vpicd_cal1 back dd ? ; Next VPICD Hw_Int callback 

currentjdt label fword ; Temp storage for current IDT 
currentjdtjimit dw ? 
current_idt_base dd ? 

align 4 

public 01d_IDT_IRQs ; Old IRQ vectors for 

OldJDTJRQs dd N_HANDLERS dup (?) ; all IDTs 

VxD_LOCKED_DATA_ENDS 

VxD_L0CKED_C0DE_SEG 


You can also statically load the VxD by adding a line like 
this: 

device=irqmon.vxd 

to system .ini. But note that in this case there are problems 
with Windows, which changes the serial port speed to 2400 
baud during comm. d rv initialization. It is necessary to type a 
mode command at a DOS prompt afterwards to restore the 
correct speed. 

Program Output 

When you install the VxD and reboot, it sends lines of text 
to the serial port, in the following forms: 

h IRQ number 

&hhhhhhhh New IDT address added to list 

=h-hhhhhhhh+hhhhhhhh IRQ Vector update 
$hhhhhhhh Old IDT address removed from list 

All numbers are hexadecimal. 

The IRQ monitoring can be selectively disabled by clearing 
the corresponding bits in variable dwIrqMask in hookirq.asm. 
Bit 0 corresponds to IRQO; bit 1 to IRQ1, etc. This is useful 
because the numerous IRQOs are usually a nuisance, and oth¬ 
ers may be as well depending on the system, and what is 
being observed. 

Log characters are output at 19200 baud on a serial line. To 
display them on a PC, use the Windows terminal, for example. 
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This requires a serial port with a FIFO (NS550) to avoid losing 
characters on reception. The speed can be increased by chang¬ 
ing constant BAUDS in comport, a sin (also supplied on the code 
disk). Do not make it slower than 19200 baud, as this may 
impact performance on the monitored system. The port can be 
changed by changing the I/O base address in variable dwPort 
in comport.asm. 

When the PC has two external serial ports, it is possible to 
monitor IRQs locally by connecting the two ports together. In 
this case, it is necessary to change the dwIrqMask flags in 
hookirq.asm to exclude the IRQ of the serial port used for 
reception, else there would be an infinite loop. 

Possible Extensions 

This program can easily be extended to monitor other 
aspects of Windows' inner workings. For example, VMM mes¬ 
sages can be monitored. Indeed, I built on this code to moni¬ 
tor power management transitions. It could also be adapted to 
the Win32 DeviceloControl interface. This would only work 
under Windows 95, but the benefit would be to allow you to 
dynamically configure it, instead of having to recompile it if 
you change anything. The drawback is that Win32 makes it 
easy to load a VxD, but not to leave it in memory afterwards. □ 

(Listing 3 is continued on page 36.) 


Listing 3 continued 


Function: My_IRQ_Handl er 

Description: Intercepts all IRQs from all IDTs 

Notes: Sends one character on a COM port, 

identifying which IRQ occured. 


MyJRQJandler 

proc C public 


INDEX - 

0 


REPEAT 

NJANDLERS 

; One entry point per IRQ 

push 

eax 


mov 

eax, INDEX 

; Identifies the IDT and IRQ 

jmp 

near ptr @F 


INDEX - 

ENDM 

INDEX+1 


.ERRNZ ($ -My_ 

IRQ_Hand1er) - (N_ 

HANDLERS * HANDLER_SIZE) 


call 

SendNibble 

; Display the IRQ number 

mov 

eax, ss:01d IDT IRQs[eax*4] ; Prev. hdlr adr 

xchg 

eax, ss:[esp] 

; Restore the initial EAX 

ret 


; Chain to the prev. handler 

My_IRQ_Handler 

endp 



Function: vpicd_cal 1 back 

Description: Called by VPICD after every IRQ 


vpicd_cal1 back proc 

pushad ; Save whatever the C code may trash 
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Listing 3 continued 


sidt current_idt ; Get the current IDT location 
cCall Add_IDT, <current_idt_base> ; Analyse it 

popad 

jmp next_vpicd_ca11 back 
vpicd_cal1 back endp 


Function: VPICD_Hook_IRQs 

Description: Hook VMM IRQs using the standard method 

Regs altered: EAX, EBX, EDX 


VPICD_Hook_IRQs proc C public uses ESI 

pushfd 

cli ; Begin critical section 

mov esi, 0FFSET32 vpicd_cal1 back 
VxDCall VPICD_Call_When_Hw_Int 
mov next_vpicd_cal1 back, esi 

popfd ; End critical section 

ret 

VPICDJookJRQs endp 


Function: VPICD_Unhook_IRQs 

Description: Unhook VMM IRQs using the standard mthd 

Regs altered: EAX, EBX, EDX 

Notes: Restores the initial IRQ hook handler. 



Will crash eventually if someone else 
has hooked them after us. 

VPICD_Unhook_IRQs proc C public uses ESI 

pushfd 

cli 

; Begin critical section 

mov 

esi, next vpicd callback 

VxDCall 

VPICD_Call_When_Hw_Int 

popfd 

; End critical section 

ret 

VPICDJnhookJRQs endp 

; Function: 

GetldtBase 

; Description 

Get the base of the current IDT 

; Returns: 

The 32-bits linear address of the IDT 

GetldtBase 

proc C public 

si dt 

current idt 

mov 

eax, current idt base 

ret 

GetldtBase 

endp 


VxD_LOCKED_CODE_ENDS 

END 

: End of File 
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Bug++ of the Month 

Mark Nelson 


To developers, software bugs are like the weather — every¬ 
one talks about them, but nobody seems willing to do any¬ 
thing about them. Until recently, I shared that view. The con¬ 
ventional anti-bug tools I knew about consisted of just a few 
elements: careful design, various testing techniques, good 
beta testing, and rigorous Q/A. 

A Different Approach 

Unfortunately for all of us, the traditional bug fix and pre¬ 
vention programs aren't doing the job. I'm not sure if the State 
of the Union vis-a-vis bugs is getting worse, but it certainly 
isn't getting better. 

In the December 1989 issue of Communications of the ACM, 
perpetual gadfly Edsger W. Dijkstra published an intriguing 
essay called "The Cruelty of Really Teaching Computer 
Science." In it, he described how he required undergraduate 
CS students work for an entire semester with nothing more 
than pencil and paper. Their assignment? Proofs, proofs, and 
more proofs. 

What does this have to do with programming? It seems 
that in academia there is a grail-like construct known as a 
"provably correct program." After reading Dijkstra's paper, I 
began to notice more and more attention being paid to math¬ 
ematical proofs from my professors (who are guiding me 
through the world's lengthiest quest for a Master's degree). 


An Implementation Problem 

This is a pretty exciting idea! As you write your latest soft¬ 
ware masterpiece, you simultaneously build a framework that 
enables you to prove that it is performing exactly as specified. 
Maybe your development environment helps you build the 
proof as it builds your code. 

As I recall, this notion even infected some of the Star Wars 
team assembled by the Reagan Defense crew back in the 80s. 
The Star Wars program envisioned building killer satellites 
with x-ray laser targeting abilities. These satellites would con¬ 
trol the annihilation of dozens of incoming Soviet ICBMs in a 
matter of minutes. The proof paradigm would help ensure 
that the targeting software would not decide to destroy a 
gross of compact cars on the LBJ freeway during Dallas's 
morning rush hour. 

If it's good enough for Star Wars, it ought to be good 
enough for you, me, and Microsoft, right? Well, as it turns out, 
not quite. It seems that the procedural languages (read C and 
C++) in vogue today are so fraught with side-effects and 
unforeseeable consequences that it's impossible to develop a 
proof for even a one-screen program. 

So how do we attack this problem? If it means giving up 
C++ and moving to Prolog, I think we have a serious imple¬ 
mentation problem. But remember, in academia, implementa¬ 
tion is simply a detail that is dismissed as trivial in the last 
paragraph of your paper. 


Mark Nelson is a programmer for Greenleaf Software in Dallas, Texas. Mark is the author o/The C++ Programmer's Guide to the 
Standard Template Library , from IDG Books, as well as The Data Compression Book, from M&T Books. You can reach Mark on 
the Web at http://web2.airmail.net/markn. 
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Compiler Issues 

Even if we did manage to develop techniques for creating 
flawless C++ programs, we would still be shipping buggy 
software. Why? It seems that code generation problems are 
endemic to today's generation of compilers. Write the cleanest 
code the world has ever seen, and you still might end up ship¬ 
ping a product with critical bugs introduced by your compil¬ 
er. 


a 16-bit word. If the compiler subsequently cleared the upper 
16 bits of the resulting value, everything would be okay. But 
as the code below shows, the faulty value of i is used as an 
array index without the necessary cleanup: 


OOOOf 

8b 

45 

fc 

mov 

eax, 

DWORD PTR _i$[ebp] 

00012 

33 

c9 


xor 

ecx, 

ecx 

00014 

8a 

4c 

45 f5 

mov 

cl, 

BYTE PTR _bug$[ebp+eax*2+l] 


A Visual C++ user named Stefan Lippstr eu recently post¬ 
ed an example of a bad code generation bug in Microsoft's 32- 
bit compiler. bug0396. cpp (Listing 1) shows the C++ code 
needed to provoke this particular bug. It seems that Visual 
C++ 2.2 has a problem when using a 16-bit value as an array 
index. When compiled with the / Od option, bug0396. cpp will 
reliably generate an exception under Windows 95 or NT. 

The problem is really a simple one. For some reason, Visual 
C++ decides to load the value of i as a 32-bit value instead of 


The result? Generally it means that the index yields an 
address that's far out of range, resulting in a GPF. Fortunately, 
Microsoft acknowledged this bug, and indicated that it has 
been fixed in the current release, Visual C++ 4.0 

An Imperfect World 

As Stefan has shown, writing a provably correct program 
doesn't do any good if the compiler fails to generate good 
machine code. And at this time, Microsoft and Borland 


Listing 1 bug0396.cpp 


// 

// BUG0396.CPP 
II 

// This program demonstrates a bug in Visual C++ 2.2. When using 
// the stack variable i as an index, and when building with optimization 
// turned off, VC++ generates code that inadvertently loads 32 bits 
// from the stack instead of just 16. This means that the upper 16 bits 
// of i are totally random stack values. 

II 

II This will usually cause a GPF. If you are lucky enough that the stack 
// was initially set to all Os, you can force an error by storing some bad 
// values in the 16 bits before i on your own, by defining the FORCE 
// macro. 

II 

II In either case, the generated code can be seen with the /FC option, and 
// it clearly shows that eax is loaded with a DWORD from the stack, but 
// the upper 16 bits are never cleared. 

II 

II Build using: 

II 

II cl /Zi /Od /Fc bug0396.cpp 
// 

// -or- 
II 

II cl /Zi /Od /Fc /DFORCE bug0396.cpp 
// 

main!) 

{ 

unsigned short i; 
unsigned short bug[ 1 ]; 

#1f defined! FORCE ) 
long *p = (long*) &i; 

*p Oxffffeeee; 

#endif 


i - 0; 

Int j - ( bug[ i ] & OxffOO ) | ( ( bug[ i ] » 8 ) & Oxff ); 
return 0; 


//End of File 


haven't issued any timetables for releas¬ 
ing code generators that have been 
proven correct. 

For his hard work, Stefan will receive 
a newly remodeled WDJ t-shirt, and our 
hearty thanks. You can join Stefan and 
receive your 15 minutes of fame by sub¬ 
mitting a bug that I use in this column. 
Just send mail describing your problem 
to wdletter@rdpub.com. □ 
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let us know. Just copy or clip this 
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Rotating Delphi Fonts 

George Tylutki 



Borland's Visual Component Library (VCL) encapsulates many Windows API 
structures and functions, but not all. In particular, the VCL font support does not 
include an easy way to create a font rotated by a certain number of degrees. This arti¬ 
cle shows how to go directly to Windows API to get a finer degree of font control 
than Delphi provides by default. The code includes a short demonstration of how to 
create rotated fonts in Delphi. 

The TFont Class 

The TFort class has properties for Height, Pitch, Style, Name, Size, Color, Handle, 
and Pi xel sPerlnch. Assigning a new value to one of the first five properties initiates 
a complicated series of calls that results in deletion of the old font and creation of a 
new font. For example. 

Label 1.Font.Name := ’Times New Roman’ 

will cause a new font to be created (if the new name is different from the current 
one). This can be disconcerting if you are accustomed to explicitly calling the 
Windows API functions CreateFont Indi rect(), SelectObjectO, and DeleteObject() 
when dealing with fonts, but most of the time a TFont is sufficient, and easy to use. 
Still, as shown in Figure 1, this only partially encapsulates a Windows LOGFONT struc¬ 
ture. When you need to manipulate another font attribute, such as specifying 
OEM_CHARSET, 0UT_TT_P RECIS, PR00F_QUALITY, CLI P_EMBEDDED, or a nonzero 
If Escapement (rotation) value, you must create the font yourself, usually via 
CreateFontlndi recto. 

Direct Font Creation 

mai n. pas (Listing 1) shows how to create a font using direct Windows API calls in 
order to change a font's escapement value. This value is roughly the number of 
degrees (in tenths) that a line of text is rotated counterclockwise from the x axis when 
written to the screen. The program (see Figure 2) writes the text contained in the edit 
component (MainEdit) centered in an image component (MainImage). MainImage's 
font's name can be changed by selecting a name from the combobox (FontNamesCB), 
and the escapement can be changed by sliding the scroll bar (EscSBar). Pressing the 
"redraw now" button (SBtnRedrawNow) will cause the text to be redrawn. If the "auto 
redraw" button (SBtnAutoRedraw) is depressed, the text will automatically be 
redrawn whenever a change is made to the font (name, size, style, or escapement, 
but not color). You can also modify the font by pressing the Font button 
(SBtnChooseFont), which invokes a common font dialog. 

The function MakeNewFont () in main.pas (Listing 1) handles creating a new font. 
Ma keNewFont () first calls GetOb j ect ( ) to fill a t Log Font record with the various attrib¬ 
utes of the current font, then sets the fields for 1 f FaceName, lfHeight, 1 f Escapement, 
IfWeight, lfltalic, lfUnderline, and lfStrikeOut. Finally, Ma keNewFont () passes the 
t Log Font record to CreateFontlndi rect () to create the font. 

When creating a font, a user typically specifies the font's character pitch (average 
width) in points, where one point is 1/72 of an inch. Because the character width 
field (1 fWi dth) in the t Log Font record passed to CreateFontlndi rect () must be in log- 


George Tylutki holds a Ph.D. in English and is a partner in 100% Cotton Software (RR1, 
Box 1622, Hop Bottom, PA 18824), which publishes NFL Forecaster, Have You Read 
That Movie?, and other programs. 


Windows Developer’s Journal — Page 39 

















Win32 SDK Online Help 


die Edit Bookmark Qptions Help 


JxJ 


i;ontents| index | Back | Pnnl | << j >>' 


LoadString QuicKInfo Overview Group 


The LoadString function loads a string resource from the 


Annotate 


Current Annotation: 


Even though resource strings are stored as Unicode for both 
Win95 and NT programs, Win95 does not provide an 
implementation ot the Unicode version of LoadStringO 
(LoadStringWO), This usually trips up NT programmers who 
want to create a single .exe for both operating systems and yet 
still use Unicode under NT. In that case, you must at runtime 
detect that you are running under Win95 and, in that case, 
explicitly call LoadStringAO. Otherwise, if you have compiled 
with .UNICODE defined, LoadStringO will expand into 
LoadStringWO, which is just a stub that fails under Win95. 

Submitted by Paula Tomlinson. 
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"Visual DLL does the near-impossible, 
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DLL. creating classes of applications 
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"Creating a DLL with Visual DLL is a 
surprisingly simple process. You can 
create DLL's callable from any lan¬ 
guage. It's easy, fun and fast!” 

- VB Tech Journal, 

June 1995 
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• Create component objects with 
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• Creates the true Windows DLL inter 
face. This means applications can 
use the DLL API interface to call 
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• Split up large Visual Basic apps into 
smaller more manageable components. 

• Create call-back procedures! Create 
File Manager extensions! Create 
add-on's and Wizards! Create 

Control Panel “applets"! 

• Automatically generates 
C header files and Basic 
Declare statements. 



TO ORDER OR FOR MORE INFORMATION, CALL: (800) DLL-2405 or (310) 575-5047 
Fax: (702) 831-9711 CompuServe: GO SIMSOL 
email: 74777.3221@compuserve.com 

Simply S>lutions, PO Box 930 Tahoe Blvd., Suite 802/374, Incline Village, NV 89451 
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ical units (usually pixels), this requires 
an intermediate calculation. You have 
to determine the number of horizontal 
pixels per inch on the current display 
by calling GetDeviceCaps(hDC, 
logPixelsY). However, Delphi deter¬ 
mines that value at startup and stores it 
in Screen.PixelsPerlnch (it does not 
determine nor store logPixelsX). Note 
that display device drivers almost 
always return a number for horizontal 
pixels per inch that is based on their 
logical resolution, not the physical size 
of the screen. That means that a 10- 
point font will rarely be 10/72 of an 
inch wide if you measure it on the 
screen. Using the indicated algorithm, 
however, will ensure that your 10-point 
font appears the same size as any other 
Windows program's 10-point font. 

If Ma keNewFont ()'s call to 
CreateFontlndi rect () is successful, the 
new font handle is assigned to 
MainImage.Font.Handle. Delphi will 
implicitly delete the font associated 
with the old handle. To change a font's 
weight, character set, etc., assign a 
value to the appropriate field of the 
tLogFont before calling CreateFontlndi rect (). When the pro¬ 
gram ends, the last font you've assigned to a font's handle will 
be deleted automatically; thus, you should not attempt to 
delete the font in OnCl OSeQuery (). 

When you assign a new handle to a font, Delphi does not 
fill in the other properties (name, size, etc.) with new values 
that correctly reflect the new font. For example, after creating 
and assigning a new font, if you ask for its name, you will get 
the old name. Therefore, you must maintain information 
about the new name yourself. In main.pas (Listing 1), this is 
done with a separate record called TheFontRec. 

Finding Available Fonts 

You can fill a listbox or combobox with the names of the 
available screen fonts by assigning Screen.Fonts to the boxs' 
Items property: 

FontNamesCB.Items := Screen.Fonts. 

You can also do this for Printer.Fonts. Delphi compiles this 
list of font names at startup, but it maintains no other infor¬ 
mation, such as available sizes or font type (TrueType, raster, 
vector), ma i n. pa s displays a small graphic to the left of the font 
names in the combobox because (1) it's standard practice to do 
so, and (2) non-TrueType fonts can't be rotated, so the pro¬ 
gram needs to know which are TrueType. 

To traverse the available fonts, main, pas calls 
EnumFontFami 1 ies( ), passing it the display context of the main 
form along with the address of a callback function. With the 
Delphi option Options I Project I Code 

Generation I SmartCallBacks checked, you do not have to use 
MakeProcInstance( ). In the callback function (EnumFontsProct)) 
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antiquated editing tool that is inadequate, inflexible 
and slow. In order for you to work effortlessly 
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an editing environment which is cus- j 

tomizable, intuitive, and powerful is a 
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development needs. Multi-Edit is 
extremely easy to use, richly featured, 
and offers seamless integration 
and full reconfigurability - 
an editor which works 
the way you work! 
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"on the fly" without touching any macros or .ini files. The 
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personalized seamless IDE. 
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extensive language support which includes Smart Indenting, 
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and Modula-2. Language sensitive syntax highlighting 
makes scanning through large portions of code a breeze. You 
can also compile from within Multi-Edit - it even offers auto¬ 
matic error location. Plus, if your favorite compiler isn't cur¬ 
rently supported, we'll write support for it free of charge! 

For today's developers, Workgroup support is no longer a 
luxury, it is a re quirement . Multi-Edit addresses this by pro¬ 
viding unparalleled integration with most VCS systems such 
as PVCS, TL1B, Source Safe, Versions, CA-LCM and MKS- 
RCS. Of course, complete network support including file 
locking, multi-user configuration, and MAPI/MS-Mail inte¬ 
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jects, Multi-Edit's session manager will save your entire edit¬ 
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if the font is TrueType, the font's name and a pointer to True 
are inserted into the font names combobox via AddOb ject (). If 
it is not a TrueType font, only the name is inserted in the com¬ 
bobox. Adding a pointer to TrueTypeBM would work just as 
well; the idea is to set Items. Ob j ect to some non-ni 1 value (it's 
nil by default). 


When creating the form, I set FontNamesCB's Styl e property 
to csOwnerDrawFixed. In the OnDrawItem event handler 
(TMainForm. FNamesCBDrawItem), I used TextRectO to display 
the font's name. This will clip the text so it doesn't spill over 
onto the combobox's button. Then, if Items.Object[Index] is 
non-n i 1 (indicating the font is a TrueType font), and 



Figure 2 The demo program in action 


Listing 1 Demonstration of rotatable fonts 
in Delphi 


unit Main; 

interface 

uses 

SysUtils, WinTypes, WinProcs, Classes, Graphics, Controls, 
Forms, Dialogs, StdCtrls, Buttons, Menus, ExtCtrls; 

type 

TFontRec - record 
ColorText : tColor; 

ColorBack : tColor; 

FontHandle : hFont; 

FontSize : integer; 

FontName : tFontName; 

Escapement ; integer; 

Style : tFontStyles; 
end; 

TMainForm - class(TForm) 

MainMenu: TMainMenu; 
mmFile: TMenuItem; 

smExit: TMenuItem; 
mmEdit: TMenuItem; 
smChooseFont: TMenuItem; 
smRedrawNow: TMenuItem; 
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TrueTypeBM is not nil (indicating that it was created and 
loaded without error), I draw a small bitmap to the left of the 
font's name. Otherwise, I just draw the name. 

Calling the Choose Font Common Dialog 

I invoke the common dialog for choosing fonts by declar- 


Li sting 1 continued 


smAutoRedraw: TMenuItem; 

Tool Bar: TPanel; 

FNamesCB: TComboBox; 

EscSBar: TScrollBar; 

EscLabel: TLabel; 

EscBevel: TBevel; 

SBtnAutoRedraw: TSpeedButton; 

SBtnRedrawNow: TSpeedButton; 

SBtnChooseFont: TSpeedButton; 

MainImage: TImage; 

MainEdit: TEdit; 

CommonFontDlg: TFontOialog; 
procedure FormCreatetSender: TObject); 
procedure smExitClick(Sender: TObject); 
procedure smChooseFontClick(Sender: TObject); 
procedure smAutoRedrawClick(Sender: TObject); 
procedure smRedrawNowClickfSender: TObject); 
procedure FNamesCBDrawItemtControl: TWinControl; 

Index; Integer; Rect; TRect; State: TOwnerDrawState); 
procedure MakeNewFontThenRedraw; 
function MakeNewFont ; boolean; 
procedure MainlmageRedraw; 
procedure OnChangeMaybeRedrawtSender: tObject); 
procedure EscSBarScroll(Sender: TObject; Scrol1 Code: 
TScrol1 Code; var Scrol1Pos: Integer); 
private 

TheFontRec : TFontRec; 

TrueTypeBM : TBitmap; 

AutoRedraw : boolean; 
end; 

var 

MainForm: TMainForm; 


implementation 

const 

DegreeSymbol - #176; 

{$R *.DFM} 

{$ R F0NTD2.RES} 


function EnumFontsProctvar Log Font: tLogFont; var TextMetric; 

tTextMetric; FontType: integer; Data: pointer): integer; export; 
begin 

Result 1; 

if (TextMetric.tmPitchAndFamily and tmpf_TRUETYPE) > 0 then 
MainForm.FNamesCB.Items.AddObjectCStrPasdogFont.lfFaceName), 
pointer(True)) {if TrueType then store non-nil value) 
else {else leave nil) 

MainForm.FNamesCB.Items.Add(StrPas(LogFont.IfFaceName)); 
end; 


procedure TMainForm.FormCreatetSender: TObject); 
var 

DC: hDC; 
begin 

TrueTypeBM tBitmap.Create; 
try 

TrueTypeBM.Handle LoadBitmapthlnstance, 'BMTRUE'); 
except {couldn't create or couldn't load bitmap) 
TrueTypeBM.Free; {and display error message) 

end; 

DC GetDC(O); 

EnumFontFamiliestDC, nil, @EnumFontsProc, nil); 


Listing 1 continued 


ReleaseDC(0, DC); 

with TheFontRec do 
begin 

ColorText clBlue; 

ColorBack clWhite; 

FontHandle 0; 

FontSize 14; 

FontName 'Arial'; 

Escapement ;- 0; 

Style []; 
end; 

Mainlmage.Canvas.Brush.Color TheFontRec.ColorBack; 

FNamesCB.Itemlndex FNamesCB.Items.IndexOf(TheFontRec.FontName); 
EscLabel.Caption IntToStr(EscSBar.Position) + DegreeSymbol; 
AutoRedraw false; 

MakeNewFontThenRedraw; 

end; 


procedure TMainForm.smExitClickCSender: TObject); 
begin 

TrueTypeBM.Free; {OK, even if nil) 

Close; 

end; 


procedure tMainForm.OnChangeMaybeRedraw(Sender: tObject); 
begin 

if AutoRedraw then 

if Sender - MainEdit then MainlmageRedraw 
else MakeNewFontThenRedraw; 
end; 
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ing an object of type TFontDialog, setting its Font property to 
the current font, and then calling its Execute procedure (see 
TMainForm.smChooseFontClickO in main.pas). Delphi's 
TFontDialog.Execute procedure initializes the TLogFont struc¬ 
ture of a TChooseFont structure through a call to GetObject and 

Listing 1 continued 


procedure TMainForm.smChooseFontC11ck(Sender: TObject); 
var 

NeedNewFont : boolean; 
begin 

NeedNewFont false; 

CommonFontDlg.Font MainImage.Canvas.Font; 

if CommonFontDlg.Execute then 
begi n 

{if only color changed don’t make new font) 
if (CommonFontDlg.Font.Name <> TheFontRec.FontName) 
or (CommonFontDlg.Font.Size <> TheFontRec.FontSize) 
or (CommonFontDlg.Font.Style <> TheFontRec.Style) 
then NeedNewFont true; 

FNamesCB.Itemlndex FNamesCB.Items. 

IndexOf(CommonFontDlg.Font.Name); 

TheFontRec.FontSize CommonFontDlg.Font.Size; 
TheFontRec.Style Common FontDlg.Font.Sty 1e; 

TheFontRec.ColorText Common FontDlg.Font.Color; 
if NeedNewFont then MakeNewFont; 
if AutoRedraw then MainImageRedraw; 
end; 
end; 


procedure TMainForm.smAutoRedrawClick(Sender: TObject); 
begin 

AutoRedraw not AutoRedraw; 
smAutoRedraw.Checked AutoRedraw; 
smRedrawNow.Enabled not AutoRedraw; 
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ment 
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passes it to the common font dialog. However, not all of the 
information in the TLogFont structure is retrieved upon return 
— just those attributes that are contained in a TFont structure. 
To get around this restriction, simply create a structure to pre¬ 
serve the relevant information — TheFontRec in main.pas. 


Listing 1 continued 


SBtnAutoRedraw.Down AutoRedraw; 

SBtnRedrawNow.Enabled ;- not AutoRedraw; 
if AutoRedraw then 

{if only text changed then don’t make new font) 
if (TheFontRec.FontName <> FNamesCB.Text) 
or (TheFontRec.Escapement <> EscSBar.Position) then 
MakeNewFontThenRedraw else MainImageRedraw; 
end; 


procedure TMainForm.smRedrawNowClicktSender: TObject); 
begin 

MakeNewFontThenRedraw; 

end; 


procedure tMain Form.MakeNewFontThenRedraw; 
begin 

if MakeNewFont then MainlmageRedraw; 
end; 


function tMainForm.MakeNewFont ; boolean; 
var 

tempLogFont ; tLogFont; 
begin 

Result true; 

GetObject(Main Image.Canvas.Font.Handle, 

SizeOf(tempLogFont), AddrttempLogFont)); 
with tempLogFont, TheFontRec do 
begin 

Escapement EscSBar.Position; 

1fEscapement Escapement * 10; 

FontName FNamesCB.Text; 

StrPCopydfFaceName, FNamesCB.Text); 

lfHeight - MulDivtFontSize, Screen.PixelsPerlnch. 72); 

lfWidth 0; {let FontMapper map width to height) 

if fsBold in Style then lfWeight fw_Bold 

else lfWeight := fw_Normal; 

lfltalic byte(fsItalic in Style); 

1fUnder!1ne bytetfsUnderline in Style); 

lfStrikeOut byte(fsStrlkeOut in Style); 

FontHandle CreateFontlndirect(tempLogFont); 
if FontHandle - 0 then 

Result false {and display error message) 

else 

MainImage.Canvas.Font.Handle FontHandle; 
end; 
end; 


procedure tMainForm.MainlmageRedraw; 
begin 

Mainlmage.Canvas.FillRect(Rect(0, 0, Mainlmage.Picture.Width, 
Mainimage.Picture.Height)); 
if MainEdit.Text <> " then 
begin 

Mainlmage.Canvas.Font.Color TheFontRec.ColorText; 
Mainlmage.Canvas.TextOutt Mainlmage.Picture.Width div 2, 
Mainlmage.Picture.Height div 2, MainEdit.Text); 
end; 
end; 


procedure TMainForm.FNamesCBDrawItem(Control: TWinControl; 

Index; Integer; Rect; TRect; State; TOwnerDrawState); 
begin 

with FNamesCB do 
begin 

Canvas.FillRect(Rect); 

Canvas.TextRecttRect, Rect.Left + 18, Rect.Top, Itemstlndex]); 
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TFont does not maintain a font's weight in a separate field, 
because a user can choose only regular and bold in the com¬ 
mon font dialog. A font's weight is encoded in the TFontStyle 
set (see Figure 1); if it's not bold, it must be regular. 

After executing the common font dialog, I check to see 
which aspects of the font actually changed. I don't have to cre¬ 
ate a new font if the name, style, and size have not changed, 
and I do not have to redraw the text if the color also has not 
changed. Because Windows caches TrueType fonts for reuse, 
there would be no problem creating a new font identical to the 
current one, except that it would waste time. 

However, in the On Sc roll event handler of EscSBar (the 
scroll bar that lets the user select a different rotation angle), a 
check is made to determine whether the user has released the 
thumb tab, so that a series of fonts won't be created if the user 
slides the thumb tab back and forth without releasing the 
mouse button. 

Direct Font Creation 

In main.pas, I assign the new fonts permanently to 
Mai nImage. Font.Handle to ensure they will be used whenever 
Mai nImage needs to display text. However, if you need a spe¬ 
cial font only at a particular time, you can use the convention¬ 
al Windows method: create the font, select the font into the 
display context (Canvas.Handle), write the text, and so on — 
for example, 

GetObj ect(Main Image.Canvas.Font.Handle, 

SizeOf(tempLogFont), addr(tempLogFont); 
tempLogFont.lfEscapement := 1800; 

Sentry Spelling- 
Checker Engine. 

Easy to Integrate. Easy to Use. 

When you add a spelling checker to your 
application, you want easy integration and 
features your customers demand. 

That’s why we designed the Sentry Spelling- 
Checker Engine to integrate with your app in 
minutes — not days or weeks. You’ll appreciate 
its otherfeatures, including network support, 
source code availability, and its ability to spell 
check individual words, text strings, and edit 
controls. 

Your customers will appreciate the way it works: 

Just like the spelling checkers in leading word 
processors. 

The Sentry Spelling-Checker Engine from 
Wintertree Software. 16 and 32 bit DLLs just 
$169 each. Source code available. 

Win+eH^ee Sof+wai^e. Z)n<z. 

613-825-6271 • Fax: 613-825-5521 
wsi@fox.nstn.ca • http://fox.nstn.ca/~wsi/ 


NewFontHandle := 

CreateFontlndirect(tempLogFont); 
OldFontHandle := SelectObj ect( 

Main Image.Canvas.Handle, NewFontHandle); 
MainImage.Canvas.TextOut( 

10, 10, Stringl); {Stringl upside down} 
DeleteObject(SelectObject( 

Mainlmage.Canvas.Handle, OldFontHandle); 
MainImage.Canvas.TextOut( 

10, 150, String2); {String2 rightside up} 


Here, rather than changing Main Image's font permanently, a 


Listing 1 continued 


if (Items.0bjects[Index] <> nil) {it’s a TrueType font) 
and (TrueTypeBM <> nil) then {and the bitmap is OK) 
Canvas.BrushCopy( BoundstRect.Left + 2, Rect.Top + 2, 
TrueTypeBM.Width, TrueTypeBM.Height).TrueTypeBM, 
Bounds(0, 0, TrueTypeBM.Width, TrueTypeBM.Height), 
clSilver); 
end; 
end; 


procedure TMainForm.EscSBarScrolKSender: TObject; 

Scrol1 Code: TScrol1 Code; var ScrollPos: Integer); 
begi n 

EscLabel.Caption IntToStr(ScrollPos) + DegreeSymbol; 
if AutoRedraw then 

if (Scrol1 Code in [scLineUp, scLineDown, scPageUp, scPageDown, 
scPosition, scEndScrol1]) then MakeNewFontThenRedraw; 
end; 

end. 

{ End of File ) 


more than just a Database Browser 


Strings 

Integer 

Long 

Float 

Double 

♦ 

Field 1 

123 

35686 

23.9 

6736755,000 


Field 2 

5784 

35686 

345.786 

6736755,000 


Field 3 

32464 

35686 

78 86 

6736755,000 

— 

Field 4 

7637 

35686 

345 

6736755,000 
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Edit[T]able 

The purpose of Edit[T]able is to provide a table structure on screen as an 
interface between an end user, browsing or typing in data, and the application 
managing the data. Edit[T]able DLL is database independent. 

The transfer between the end user and the DLL is supported by WINDOWS' 1 , 
the transfer between the DLL and the application is done via classes and calls 
to their virtual functions, i.e. the functions are coded in the application, but 
called from the Edit[T]able DLL. 

In C applications, the virtual functions are replaced by function pointers. 
Supported field types: 

String Integer Long Float Double Date Time 

The layout and the attributes of the table structure and the fields are to be 
defined with a separate design tool(included), so that you can change these 
attributes without re-compiling the application. 

A free demo disk with examples for linked list, array structure and PARADOX® 
Engine is available. 

Soln-ssir. 23 u w" 8 +49 30 692 44 95 

10961 Berlin ; +49 30 692 35 55 

Germany ' ik 100325.1266 


The layout and the attributes of the table structure and the fields are to be 
defined with a separate design tool(included), so that you can change these 
attributes without re-compiling the application. 

A free demo disk with examples for linked list, array structure and PARADOX® 
Engine is available. 

Soimsslr. 23 vtiill® 1 '''/ •. o»» 8 +49 30 692 44 95 

10961 Benin Jg-SS" J F,< +4S 30 692 35 55 

Germany ' ik 100325,1266 
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new font is temporarily selected into its 
display context for a special effect and 
then deselected and deleted. 


Figure 1 Delphi font defaults 


Delphi "defaults" 
when a font is created 

(Font.Height [10]) 

( 0 ) 

( 0 ) 

( 0 ) 

(Font.Style [fw_Norr»al]) 
(Font.Style - 0) 

(Font.Style - 0)' 

(Font.Style - 0) 

(DEFAULT_CHARSET) 

(0UT_D E FAU LT_P RECIS) 
(CLIP_DEFAULT_PRECIS) 
(DEFAULT_QUALITY) 
(DEFAULT_PITCH) 

(Font.Name [’System']) 


TFont - class(TGraphicsObject) 

property Handle: HFont read GetHandle write SetHandle; 

property PixelsPerlnch: Integer read FPixelsPerlnch write FPixelsPerInch; 

property Color: TColor read FColor write SetColor; 

property Height: Integer read GetHeight write SetHeight; 

property Name: TFontName read GetName write SetName; 

property Pitch: TFontPitch read GetPitch write SetPitch default fpOefault; 

property Size: Integer read GetSize write SetSize stored False; 

property Style: TFontStyles read GetStyle write SetStyle; 

end; 

TFontStyle - (fsBold, fsltalic, fsllnderline, fsStrikeOut); 

TFontStyles - set of TFontStyle; 

TFontPitch - (fpDefault, fpVariable, fpFixed); 

TFontName - string[LF_FACESIZE - 1]; 


(equivalent to Windows 
LOGFONT structure) 

TlogFont - record 
lfHeight: Integer; 

IfUidth: Integer; 

1fEscapement: Integer; 

1fOrientation: Integer; 

1fWeight: Integer; 

Ifltalic: Byte; 
lfUnderline: Byte; 

IfStrikeout: Byte; 

IfCharSet: Byte; 
lfOutPrecision: Byte; 
lfClipPrecision: Byte; 
lfQuality: Byte; 
lfPitchAndFamily: Byte; 

1fFaceName: array[0..1f_FaceSize • 1] of Char; 


Summary 

The code disk contains the complete 
source code and associated files for 
building the demonstration program. 
Delphi's TFont class makes dealing with 
fonts simple and easy, and most of the 
time it provides all of the necessary 
functionality. Because Delphi takes care 
of obtaining display contexts and 
selecting fonts into and out of the dis¬ 
play contexts, it's almost as easy to tran¬ 
scend TFont's limitations. □ 


HyperTerp 


DELPHI 

l^NGUAG E 


• A true Delphi VCL - no VBXs, DLLs or other “additional” files 

• Easy to use - Drag&Drop on the form, set 3 events handlers and go! 

• I/O and error events simplify integration with your application 

• Registration and extension events to add app. specific functionality 

• Small footprint - 150K linked directly to your application’s .EXE 

Use HyperTerp to add script language and user extensions 
capabilities to your applications. 


HyperTerp/Delphi - $149 

Royalty free 

Compiled Delphi units (,DCU) 


HyperTerp/Pro ■ 

Royalty free 
Complete source code 


[yperAq 

Inc. 


$395 


Object Inspector jj 

|HyperTerpl: THyperTerp |±| 

QnAdvanceLine 

HyperT erplAdvanceLine 

OnError 

.1 r \ Li 

OnLirieRead 

k 

OnLoopCallback 


OnRead 

HyperT erpl Read 

QriRegisterProcs 

HyperT erpl RegisterProcs 

QnWrite 

HyperT erplWrite 

1 

|j \Properties XE vents/ ; ' 


3437 335th St. West Des Moines IA 50266, USA 
Phone: (515) 987-2910 Fax: (515) 987-2909 
Home Page: http://www.hyperact.com 
Internet: rhalevi@hyperact.com 
CompuServe 76350,333 
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Need a Network Programming Solution 


NetWare® 

C++ Class Libraries for NetWare Developers 
Now with IPX/SPX/SAP Classes 


* DOS/Windows Client Libraries 

* MSVC 1.5 and Borland 4.5 

* 300+ pages of Documentation 

* Source Code Included 

* 30 Day Money Back Guarantee 

"ORC++ Objects for NetWare" 


* Bindery, Queue, Print, Print 
Capture, Connection, Work- 
Station, Dir file classes 



It rum wtth 

NetWare 

P cvciopcr Tested Only. Novell makei no wairanttei wrth raped to this product. 


4 $299.00 , 

■ 


TCP/IP 


SDK 


L P Software * 

* C Interface for 
DOS / Windows 

* Sockets Interface 

* RPC & SNMP APIs 

* Winsock Compliant 

* Visual Basic Custom I 
Controls built over 
Windows Sockets 

* Examples Included . ji 

* $369.00 ^ 



"PC/TCP OnNet 
Developers Toolkit" 




Windows NT™ 

Network programming text 

* Covers Versions 3.1 and 3.5 

* Named Pipes, NetBIOS, 
Windows Sockets, TCP/IP, 
IPX/SPX, Remote 
Procedure Calls 

* Sample apps include 
generic peer-to-peer 
networking API 

* Diskette with source 

'Windows NT Network 

Programming" Ralph 

Davis 



$36.95 JT' 




i. price . a 

f A K-v 


Programming Services 
Jump Start your Programming Project 
•Our programmers code an application skeleton 
♦Tailored to your project 
•Reasonable Cost 
•WlnSock, WlnSNMR IPX, SPX 


Additional book solutions ... 

Cbent/Server LAN Programming $44.95 

UNIX Network Programming $55.00 

UNIX System V Network Programming $47.95 
Programming WinSock $31.95 

Guide to Waiting DCE Applications $27.95 

There's more. Ask for our book listings. 


We’ve got you covered. 


’Network Programming Solutions' 
Systems Support Group 
1 - 800 - 422-6414 
International call (214) 422-6260 

P.0 Bot 940723. Plano TX 75094 
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■ Tech Tips 



Edited by Leor Zolman 


Please send us your best tricks and 
hacks - those clever pieces of code to 
make things work the way they should! 
You'll receive at least $50 for each tip 
that we print. 

Send your submissions: 

- via the Internet to: 
leor@bdsoft.com 

- from CompuServe to: 
>INTERNET:leor@bdsoft.com 

- or by regular mail to: 

Leor Zolman 

74 Marblehead Street 
North Reading, MA 01864 
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Quick Access to the Current .exe Path 


Piotr Markiewicz 
piotr@homer.iinf.gliwice.edu.pl 


My Tech Tip tells you how to get the path to the . exe file in a manner that is 
portable between DOS, Windows 3.x, and Win32. The method shown compiles 
under Borland C++ 4.5 and should be easy to port to MSVC. 

Whenever you need access to the current. exe path or the current. exe name, link¬ 
ing with the PRG_PATH library, prg_path. h and prg. path. cpp (Listings 1 and 2), allows 
the use of two special function calls. The call 

ExeDir.Get_Program_Path 0 

will fetch the program's path, and the call 

ExeDir.Get_Program_Name () 

will get the program's base filename. A short test program, testpath . cpp (Listing 3), 
illustrates the use of these calls. 

There is one trick in the code, within TExeDi r :: Ini t( ) in prg_path.cpp (Listing 2). 
In the call 

GetModuleFi1eName ((HINSTANCE)_DS, path, MAXPATH); 

the first parameter to GetModul eFi 1 eName( ) is HINSTANCE, but this is the same as the 
HINSTANCE passed to WinMai n( ). 



Easy Button Animation 


Gorkhmaz E. Mikailov 
Design Engineer, 
Digital Technics Inc. 
Columbia, MD 


Here is a simple technique you can use to animate any toolbar button in Visual 
C++ programs. The technique is based on the CTool Bar class's SetButtonInfo( ) func¬ 
tion of MFC. In the enclosed example application easyanim (included in its entirety 
on the code disk as easyanim.zip), the Print button is animated. Such animation 
could be useful during lengthy printing. 

First, select the toolbar button you wish to animate. Then, using AppStudio, cre¬ 
ate bitmap images (bitmaps) corresponding to different animation stages of the 
selected button and add these bitmaps to the end of the main frame toolbar. In the 
example, three bitmaps (indices of 9,10, and 11, respectively) are added to the end 
of the toolbar bitmap for the Print button. 

(text continued on page 50) 



Leor Zolman is a consultant specializing in C programming training, an instructor on 
UNIX topics for Boston University's Center for Information Technology, and ‘‘Tech Tips" 
editor for Windows Developer's Journal. His book, Illustrated C, was published in 1992. 
He may be contacted at 74 Marblehead St., North Reading, MA 01864. Internet address: 
leor@bdsoft.com. 
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Why in the world did 
Timberline Software 
bring 24 developers to 
our conference? 



More tools. More inteUigenee 



They didn’t want to miss anything. 

Software Development ’96 is not regarded as the Mecca of the development universe for nothing. 
There are simply tons of technical classes to attend, cutting edge tools to play with, and countless 
industry gurus barreling down the hallways. You’re going to have to bring your whole team to truly 

take advantage of everything SD ’96 has to offer. 


Get an education for your entire team 

More than 200 technical and management 
conference sessions cover your most critical issues 
in these topics: 

• Programming in C++ 

• Windows 95 & NT Development 

• Building a Software Component Strategy 

• Testing & Debugging 

• Leveraging Object-Oriented Technologies 

• Building Open & Distributed Systems 

• Multimedia & Game Development 

• User Interface Design 

• Database Development for the Enterprise 

• Client/Server Architecture & Deployment 

• Enterprise Application Re-Development 

• BackOffice Development 

• Reorganizing Development 

• Team Managers and Management 

• Managing for Quality and Productivity 

• New Practices and Processes 



Meet the engineers of more than 
500 leading tools from vendors like: 


Microsoft 

Progress 

Atria 

SunSoft 

XVT 

Borland 

IBM 

Hewlett Packard 

Visix 

Apple 

Neuron Data 

AT&T 

Powersoft 

Cadre 

SCO 

Novell 

Silicon Graphics 

Motorola 

ObjectStore 

ParcPlace/ 

InSync 

Gupta 

Digitalk 

Pure 

Intel 

Intersolv 

An tares 

Continuus 

Informix 

Rogue Wave 

Rational 

Lotus 



Hear the industry’s most intelligent - 
and influential-speakers 


Software Development Meets the Web 

James Gosling, Sun Fellow and Java Creator, 

Sun Microsystems 

Enterprise Object Strategies with Booch 
and Jacobson 

Moderated by Marie Lenzi, Object Magazine 

We Have a Draft C++ Standard-Now What? 

Bjarne Stroustrup, AT&T Fellow and C++ Creator 

Do We Build Systems or Do We Program? 

Dr. Adele Goldberg, ParcPlace/Digitalk 

Choosing Your Object-Oriented Technology 

Moderated by Peter Coffee, PC Week 

Object Models: Strategies, Patterns, 
and Applications 

Peter Coad 



Participate in valuable technical 
seminars-Free to Exhibition Attendees 


Microsoft Intel Rational 

Oracle Nu Mega Intersolv 



Discover new show floor features that bring 
you the latest tools 


Microsoft Component Builders Pavilion 
Microsoft Internet Controls Pavilion 


Web Tools Pavilion 


© Revel at the 3rd Annual 
C++ Superbowl 

Pack some serious fun into the learning process at 
the C++ Superbowl! Watch on giant screens as moder¬ 
ator Richard Hale Shaw referees 5 teams from the top 
selling C++ vendors. 


“I was part of a group of 24 developers 
sent by my company to attend the confer¬ 
ence at SD ’95. We plan on sending 40+ for ’96. 
Reason? Because SD offers education found 
nowhere else.” 


REGISTER 
AT OUR 
WEBSITE: 

http://wwv.mfi. 

com/sdconfs 


— Steve Anderson, Timberline Software Corp. 


To Register Today! Call (314) 245-8874 



Using ClassWizard, add an ON_UPDATE_COMMAND_UI handler 
for the menu item of the selected button. In the example, such 
a handler is added for the Print menu item (with an ID of 
ID_FI LE_PRI NT). This handler function rotates the different 
Print button images using SetButtonInfo( ) and the buttons' 
relative indices in the toolbar button bitmap. 

When opening any dialog boxes or selecting other menu 
items, animation of the button stops temporarily. To prevent 
this effect, you can use a timer function to run 
SetButton Inf o () and change the selected button's images 
periodically. 



Workarounds for Two DDESPY Bugs 


Moshe Rubin 
Jerusalem, Israel 
CompuServe: 73014,626 
mosher@accentsoft.com 


Energize 
Your Fax 
and Imaging 
Capabilities. 



ddespy.exe, a development tool bundled with the 
Windows SDK, is invaluable for DDE programmers. It allows 
you to "snoop" on Windows DDE transactions flying around 
the system at any point in time, ddespy dumps a textual form 
of the intercepted transactions and their parameters to any of 
the following destinations: a DDESPY 
child window, a file of your choice, or a 
debugging terminal. 

Unfortunately, ddespy suffers from 
two irritating bugs: 

(1) When dumping to its child window, 
ddespy loses output at the top of the 
listbox buffer. Often, the lost transac¬ 
tions are crucial to tracking down a 
problem. 

(2) You can solve the above problem by 
directing the output to a file. 


Qet striking results 
using Black Ice 
Software's Imaging/FAX 
toolkits. Create 
lightning fast B/W and 
color applications within 
a few days. Free of any 
royalty charges, these 
multi-platform solutions 
are powerful enough to 
brighten even the 
toughest fax and 
imaging problem. 


Complete Imaging Solutions 

► Fax Development Toolkits 

► Color Faxing Solutions 

► Fax C+ + for Windows, Win95 or NT 

► Print Drivers for Windows, Win95 or NT 
|J£j TIFF SDK compression 

Image SDK Plus 


Call today for more details! 


BLACKSilCE 


292 Route 101 Amherst, NH 03031 
Tel. (603) 673-1019 Fax. (603) 672-4112 
BBS (603) 673-6617 


Listing 1 prg_path.h 


// prg_path.h: TExeDir Class definition 

#ifndef _PRG_PATH_HPP_ 

^define _PRG_PATH_HPP_ 

//include <cstring.h> 

#include <classlib\defs.h> 

class TExeDir 
{ 

public: 

TExeDir (); 

void Init (); 

const string& Get_Program_Path (); 
const string& Get_Program_Name (); 

protected: 

bool After_Init; 
static string Program_Path; 
static string ProgramJIame; 

}; 

inline const string& 

TExeDir::Get_Program_Name 0 
{ 

if (!After_Init) 

Init 0; 


} 


return Program.Name; 


inline const string& 

TExeDir::Get_Program_Path 0 
{ 

if (!After_Init) 

Init 0; 

return Program_Path; 


extern TExeDir ExeDir; 


#endif 

/* End of File */ 
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Listing 2 prg_path.cpp 

// prg_path.cpp: Implementation of TExeDir class 

void 

::GetModuleFi 1 eName (( HINSTANCE)_DS. path. 


TExeDir::Init 0 

MAXPATH); 

include "prg_path.h" 

t 

fnsplit (path, drive, dir, name, ext); 


if (After Init) 

// end if 

#include <dir.h> 

return; 

delete path; 

//include <dos.h> 


//else 


After Init - true; 

fnsplit ( argv[0], drive, dir, name, ext); 

//ifdef Windows 


//endif 

//include <windows.h> 

char *drive - new char[MAXDRIVE]; 


//end if 

char *dir - new char[MAXDIR]; 

Program_Path - drive; 


char *name - new char[MAXFILE]; 

Program Path +- dir; 

string TExeDir::Program_Path; 

char *ext - new char[MAXEXT]; 

Program Name - name; 

string TExeDir::Program_Name; 



TExeDir ExeDir; 

//ifdef Windows 

delete drive; 


char *path - new char[MAXPATH]; 

delete dir; 

TExeDir::TExeDir () : After Init (false) 

# ifdef WIN32 

delete name; 

t 

::GetModuleFi1eName (NULL, path. MAXPATH); 

delete ext; 

) 

fnsplit (path, drive, dir. name, ext); 

) 


// else 

//End of File 


However, the lines written to the file contain byte combi¬ 
nations of LF/NUL and LF/CR, both of which should be 
CR/LF. This makes the output file practically unreadable 
in a text editor. 

Here's how to solve these problems. 

When beginning a ddespy session, direct output to a debug 
terminal by selecting the Output I Debug Terminal menu item. 
Next, open up any Windows system debugging log applica¬ 
tion. These applications capture and display all debugging 
messages from Windows API functions such as 
OutputDebugStringl ). My favorite is dbwin, another applica¬ 
tion bundled with the Windows SDK. When ddespy dumps 
the intercepted DDE transactions, the complete output will 
show up in dbwi n's window. 

fxddespy.c (Listing 4) is a short C utility that will correct 
the CR/LF problem in ddespy's output file. The program uses 
standard input and output, so here's an example of how to 
run it: 

fxddespy <ddespy.txt >fxddespy.txt 


The WIN32_LEAN_AND_MEAN Symbol 


Dan Shappir 
Tel-Aviv, Israel 
shappir@math.tau.ac.il 

While browsing several utility sources I stumbled on the 
following line: 

//define WIN32_LEAN_AND_MEAN 

The only documentation I managed to locate for this symbol 
was in the Microsoft Development Library CD 13 (October 
1995) under Product Documentation/Languages/Visual C++ 
2.1 (32-bit)/ Programming with the Microsoft Foundation 
Class Library/ Changes from MFC Version 2.0 32-Bit Edition. 
I think it speaks for itself: 



To improve build times and reduce the size of your applica¬ 
tion's pre-compiled header, MFC defines the symbol 
WIN32_LEAN_AND_MEAN. This definition lists a group of 
less commonly used header files that MFC does not automati¬ 
cally include through including AFXWIN.H. To see the list of 
header files specifically excluded from MFC builds, look at the 
definition of WIN32_LEAN_AND_MEAN in WINDOWS.H. If 
you need the definitions provided by any of those files, you 
must explicitly include the appropriate file yourself. 
WIN32_LEAN_AND_MEAN was not defined in MFC version 
2.1, and all of the extra headers were included. 


One version 
supports 
Windows 3.1, 
Windows NT and 
Windows 95 


SftTree 1.0 

Tree Control for Windows 


From simple listbox with bitmaps to multi-line, multi- 
column, hierarchical data display, SftTree delivers! 


File Name 

Description 

IT 

Size j 

♦ 

|*L Project NEWAPP.MAK 

— 

E3'C$ about c 

| Easily edit tree datej 

jqj 408 chars 




B Q app. h U sing any control (combo, edit,...) 

4429 chars 

1 s 

j^rga ji j- Text Edit Window (MDI Child) 

l “F e mi c Old MDI edit child window, needs change 

16449 chars 


in i. vl T ext Edit MDI Child Definitions 

“M edllmd,h RTF control API 

88129 chars 


|"0 <windows.h> Windows Header File 

151579 chars 


multiple columns 
multiple text lines per item 
drag & drop with auto-scroll 
single/multiple selection 
single/multiple roots 
editable item data 


columns with titles/buttons 
resizable columns 
selectable column alignment 
sorting 

standard or 3D look 
expand/collapse buttons 


/ 

/ 


Supports Windows 3.1, 
Windows NT and Windows 95 

MFC and OWL classes 
included 


/ 

/ 


Use with C, C++ (MFC, OWL) 
and other DLL-call capable 
languages 

Supports AppStudio, 
Resource Workshop and 
SDK dialog editors 


SftTree DLL (with C++classes) $249 
Source Code for SftTree DLL +$100 


VISA/MC/AMEX accepted. 

S&H additional. 

Site licensing available. 


Call today for your free demo! 


SgJuMl NnhuU 

Not The Industry Standard 

11 Michigan Ave 
Wharton, NJ 07885 


(201) 366-9618 
FAX (201) 366-3984 
BBS (201)366-3940 
http://www.softelvdm.com 
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The Microsoft Visual C++ 2.0 Books Online makes no ref¬ 
erence to this symbol. By defining WIN32_LEAN_AND_MEAN in sev¬ 
eral projects, I got a 50 percent reduction in the size of the pre¬ 
compiled header files, and, indeed, improved compile time. 
The symbol must be defined before wi ndows. h is included. 

Outsmarting Program Demons 


Homer B. Tilton 
Tucson, AZ 85710 


The other day I fired up a math program that hadn't been 
used for a while. When I invoked its command name, this 
message appeared 



timer to an earlier date! 

The next time you invoke the WhizBang command you'll see 
that message instead of arousing the demon from its sleep. 
(An easy way to create such "messenger .com files" is shown 
later. 

To get the actual program to run after you've adjusted the 
computer timer, simply change the extension on the messen¬ 
ger program from .com to .mom and invoke WhizBang again. 
Remember to restore .mom to .com when you're finished. A 
simple batch file can be set up to handle all that. 

While you may never encounter the particular demon 
described here, you may nevertheless want to preface a pro¬ 
gram with some special instruction. This procedure effective¬ 
ly lets you do that. 

To create messenger .com files the easy way, first create a 
kernel, a file containing only these eight bytes: 


Program no longer valid. Tap any key. 


BA 8 1 B4 9 CD 21 C3 


I dutifully did what it said, and the program self-destructed! 
Sneaky! After thinking about it for a bit, I imagined there was 
a demon inside the program which did the dastardly deed 
when it saw the current date and decided it didn't like it. 

I reloaded the program onto the hard disk from a backup 
floppy. Changing the program name prevented the self- 
destruction, but I still could not use the program. (With a 
name change, it evidently couldn't "find itself" when it came 
time to self-destruct.) I restored the original program name, 
cranked the computer's calendar back a year, and tried again. 
This time the program worked. Aha! So now I had to make a 
mental note to myself that whenever I use that program, I 
must first crank the computer date back. But what if I forget? 

The answer: Recall the order of search performed by DOS 
when an external command is invoked. First, DOS looks for a 
.com file with that name; if it finds none, it looks for a .exe; 
finally, it looks for a .bat. It doesn't matter which of those 
extensions you put on your command (you would normally 
put none). So if you make a . com program with the same com¬ 
mand name, then you can put your reminder message inside 
it. The message will show, but the demonized program will 
not execute. (If the program you want to pre-empt has a . com 
extension, simply rename it to have a .exe extension; DOS 
won't mind!) 

Let's say the demonized program is named WhizBang.exe. 
Create a new program named WhizBang.com which simply dis¬ 
plays the messageDon’t forget to reset your computer 


Listing 3 testpath.cpp 


// testpath.cpp: test driver for TExeDir class 

#include <iostream.h> 

#include "prg_path.h" 

void 
main () 

1 

cout « "Exe path " « ExeDir.Get_Program_Path 0 << endl; 
cout << "Exe name " << ExeDir.Get_Program_Name 0 « endl; 

1 

//End of File 


After you have the kernel file, duplicate it to, say, test. com. 

To create a two-line messenger .com file containing a third 
hidden line, enter these DOS commands: 

Echo 1st line of message. »TEST.C0M 
Echo 2nd line of message.$ >>TEST.COM 
Echo Invisible message. >>TEST.COM 


You can use more lines by obvious extension of the process. A 
dollar sign marks the end of the visible message. O 


Listing 4 fxddespy.c 


i* 

* FXDDESPY.C: Fix DDESPY’s ASCII output format 
*/ 

(/include <stdio.h> 

(/define LF 0x0a 
(/define NUL 0x00 

main () 

1 

int state = 0; 
int c; 

while ((c - getchar ()) != EOF) { 
if (state — 0) { 
if (c -- LF) 
state - 1; 
else 

putchar (c); 

1 

else { 

putchar (LF); 
if (c !- NUL) 
putchar (c); 

state - 0; 

1 

1 

return 1; 

1 

/* End of File */ 
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Foundations of Visual C++ Programming 

for Windows 95 

IDG Books Worldwide, Inc. 

Paul Yao & Joseph Yao 

807 Pages 

$39.99 

1995 

ISBN 1-56884-321-6 


I have to admire the sheer hubris of most programming 
book authors. Windows programming is a huge, complicated 
topic, as is C++, as is MFC, but just about every month a book 
like this one comes along that promises to teach you all three. 
I wish I had that kind of chutzpah — I'm happy if I can man¬ 
age to eke out an article that successfully explains one pair of 
functions in the Windows API. I'm halfway competent at C++ 
and Windows programming, and I wouldn't mind learning 
MFC if I could find a good book, so I took a look at this one. 

My radar immediately lit up in the sections that try to teach 
C++. I first spotted a statement claiming that passing a char to 
a function in C causes it to be promoted to i nt, which has been 
untrue for years. In discussing static data objects, the text says 
there "is no defined order in which objects will be initialized"; 
in fact, there is a very well-defined order, but the order that 
different modules get initialized in is not defined, which is not 
the same thing at all. The authors claim that in a class that has 
a custom new operator, C++ "doesn't specify whether you 


should allocate the space in new or in the constructor," but 
that's untrue, and a downright weird thing to say. I definitely 
do not recommend this book to anyone who wants to learn 
C++, not even the "sane subset" it claims to teach. 

The coverage of MFC, which is perhaps half the book, 
seemed a lot more competent to me, but I'm admittedly igno¬ 
rant of MFC. Unlike most MFC books, this one pretty much 
ignores the document/view model until the very end. 
Instead, it starts you off doing normal sorts of Windows pro¬ 
gramming things (creating windows, menus, dialogs, etc.), 
only using MFC instead of the raw Windows API. I think this 
approach will appeal more to programmers who already 
know Windows, but don't know MFC. It should also be more 
appealing to the many programmers who create utilities that 
don't fit the document/view model particularly well. 

Like all the other MFC books I've looked at, this one failed 
to make the MFC document/view model clear to me. As 
usual, the very highest level explanation was there (a docu¬ 
ment is data, views let you display the same data in different 
ways), and lowest-level explanations abounded (the CView 
bone's connected to the . . . CDocument bone, the CDocument 
bone's connected to the . . .), but the all-important middle 
ground was absent. I did not learn what the abstract interfaces 
between these framework components are, or how to make 
effective design decisions with them. I thought the authors' 
technique of using the debugger to learn about the docu¬ 
ment/ view model was ... unique. Perhaps they too have had 
difficulty finding any decent expositions of the subject! 



Got an opinion about these or other programming books? Send them to 70302.2566@compuserve.com. You can order any of the books 
that appear in Books in Brief from Miller Freeman, Inc. by calling (913) 841-1631, faxing (913) 841-2624, or sending email to 
rdorders@rdpub.com. If using fax or email, send the book title, author, and publisher along with your MasterCard or Visa number, expi¬ 
ration date, and phone number. 
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Finally, Paul Yao always likes to include a chapter on 
Windows memory management, and he did so here. It's a fine 
chapter, and he's one of the few people who have a good track 
record of correctly describing Windows memory manage¬ 
ment, but it doesn't really have much to do with the stated 
topic of the book. 

The cover says the book includes a CD-ROM that features 
"valuable source code," but the source code is worthless 
because the book includes a two-page legal voodoo curse that 
will cause your big toe to fall off if you actually use the source 
code for anything or even stare at the CD too long. Oh, and the 
source code is not guaranteed to be fit for any particular pur¬ 
pose, although I feel the CD will always be useful for throw¬ 
ing, Ninja-style, at cockroaches. The book is not gratuitously 
padded with code, but it is typeset in the now classic tree- 
killer style, in which three paragraphs are about all that will fit 
on a page. 

I'll continue my search for an MFC book I can love, but this 
one is at least worth a look if you're in the market. Take any¬ 
thing it says about C or C++ with a grain of salt, though. 


Network Programming with Windows 
Sockets 
Pat Bonner 
Prentice Hall 
493 pages 
$39.95 
1996 

ISBN 0-13-230152-0 

[Editor's note: This review was contributed by Victor 
Volkman.] Network Programming with Windows Sockets, by Pat 
Bonner, provides a complete tutorial of Windows Sockets 
development issues for the intermediate to advanced 
Windows C programmer. The primary development platform 
is assumed to be Windows 3.1, though exceptions for Win32 
programming are noted along the way. It also highlights dif¬ 
ferences between Windows Sockets and BSD UNIX in terms of 
syntax and semantics. Special attention is given to explaining 
blocking and nonblocking API calls, one of the most slippery 
concepts of the API. This book is the best overall treatment of 
Windows Sockets issues and coding techniques that you'll 
find anywhere. The $39.95 price includes relevant examples 
from the 500-page book on a 1.44Mb diskette. 

The discussions are grounded with pragmatic advice: 
wherever there has been controversy, ambiguity, or historical¬ 
ly poor support for a particular feature, the author is quick to 
point it out. This advice doesn't extend as far as naming 
names — it stays clear of vendor specific information. The 
overall approach works to warn you of pitfalls and traps both 
early and often. 

Since this book is intended to be a tutorial, its strength 
should lie with its examples. The first real example programs 
appear midway through Chapter 4. This chapter mainly 
develops WSAAsyncSel ect() as a method of waiting for asyn¬ 
chronous WM_S0CKET events. The actual source code in C is pre¬ 


ceded by pseudo-code describing the major event handlers 
and then an expected chronology of events. The code is pro¬ 
fusely commented, averaging one comment line for every 
three lines of code. 

Chapter 5 covers the blocking and polling socket calls in- 
depth. Your choice of asynchronous notification, blocking, or 
polling determines the structure of your Windows Sockets 
application. Though blocking calls are not recommended, 
they are given equal treatment overall and special attention 
with regards to the resulting re-entrancy issues. 

Chapters 7 and 8 provide a deeper look into using data¬ 
gram (UDP) and stream (TCP) sockets respectively. The for¬ 
mer develops a disk space information client/server pair; the 
latter develops a "PC to PC File Transfer Program." 

Chapter 9, the most ambitious in scope, covers all aspects 
of using Windows Sockets with respect to DLLs. It specifical¬ 
ly addresses socket ownership and how to share a resource 
that only belongs to one process. Bonner defines two different 
architectural models for this. Last, a sample Telnet DLL is pre¬ 
sented in both models. 

The author should be commended for not including a ver¬ 
batim copy of the Windows Sockets API specification in the 
book. A fine PostScript version of this is available on the 
Internet and the book includes appropriate pointers to speci¬ 
fications. The book could be improved by providing a 
roadmap to other RFCs that developers should be aware of. 

In one respect, the book was somewhat obsolete as soon as 
it was printed. The Windows Sockets 2.0 specification was still 
under development at the time the book was written. 
Accordingly, the author could provide only a broad overview 
of the architectural changes, in a page or so. This coverage is 
equivalent to Hall and Brown's infomercial about Windows 
Sockets 2.0 in the January 1996 issue of Windows Tech Journal. 
No doubt the second edition of the book will rectify this. 

There are some typos in figures and text in the early chap¬ 
ters that detract from the overall sound writing and organiza¬ 
tion. On a procedural level, the book frequently makes the 
mistake of first using an acronymn (e.g. BSD, ARP, ICMP, 
WinSock) but not defining it or spelling out the long name 
until as many as 20 pages later. 

The cover promises "Winsock APPLICATIONS INSIDE" 
(their caps). Though some good example programs are devel¬ 
oped along the way, a demo does not a complete application 
make. In terms of complete applications, the closest is the 
admittedly "partial" Telnet DLL source. Also, though the code 
is advertised as compatible with Microsoft's C compiler, no 
information is given as to its suitability for Borland or other 
popular environments. The memory model is the common 
"Medium" model. The applications apparently use the subset 
of functionality that behaves the same in Windows 3.1 and 
Win32 — such that no #i f defs are present. 

The book should provide more detail on name resolution, 
routing, and packet headers, all of which can be sources of 
befuddlement in installing and testing network applications. 
The author claims that the first two items are not directly 
applicable to Winsock programming and provides only a page 
of detail on them. Packet headers are included as an after¬ 
thought in the final chapter — it would make more sense to 
treat them with the introductory background material, espe- 
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dally since the book caters to an audience without "previous 
networking experience" (from the preface). By comparison, 
Doug Comer's classic Internetworking with TCP/IP, Vol. I has at 
least a chapter on each of the aforementioned background 
subtopics. 

The only technical issue really skirted is that of Out-of- 
Band (OOB) data. In several contexts, the author explicitly 
states that OOB transmission will not be discussed. However, 
this seems inappropriate given that the centerpiece of this 
book is a Telnet client which requires OOB for a full imple¬ 
mentation (as Bonner concedes in Appendix D). In the words 
of Comer: "Telnet cannot rely on the conventional data stream 
alone to carry control sequences between client and server, 
because a misbehaving application that needs to be controlled 
might inadvertently block the data stream." 


two years of onsite observation" and "forty in-depth inter¬ 
views." From this, the authors have identified seven strategies 
that they feel epitomize how Microsoft operates: 

1. Find smart people who know the technology and the 
business. 

2. Organize small teams of overlapping functional special¬ 
ists. 

3. Pioneer and orchestrate evolving mass markets. 

4. Focus creativity by evolving features and "fixing" 
resources. 

5. Do everything in parallel, with frequent synchroniza¬ 
tions. 

6. Improve through continuous self-critiquing, feedback, 
and sharing. 


I would also like to see 
Windows Sockets placed in the 
context of the larger realm of 
programming connectivity 
choices (API layers), for exam¬ 
ple, guidelines as to when you 
should choose Windows Sockets 
over a higher-level mechanism 
(e.g., RPC), a library that encap¬ 
sulates Windows Sockets calls 
(e.g., Phil Jounin's "FTP4W" and 
"TCP4W"), distributed OLE, or 
an even simpler mechanism 
(e.g., WFWG mailslots). Though 
an even-handed comparison is 
made against NetBIOS, the 
choice of correct API layer is 
equally important. 


Microsoft Secrets 
Michael A. 
Cusumano, 
Richard W. Selby 
The Free Press 
512 pages 
1995 



Michael Cusumano teaches 
strategy and technology man¬ 
agement at MIT's prestigious 
Sloan School of Management 
and Richard Selby teaches infor¬ 
mation and computer science at 
the University of California, 
Irvine. With such credentials in 
both business and computers, 
they would seem an ideal pair to 
write a book that reveals the 
secrets of Microsoft's success. 
This book is based on "almost 




Join the tens of thousands of satisfied customers 
and get a copy of Help Magician Pro, the full- 
featured stand-alone WYSIWYG Help Authoring 
Tool without the ultimate price! Thousands of 
man hours, customer suggestions, and foresight 
went into creating a product that will make your 
job a breeze in creating online documents and 
help files for WinHelp. Help Magician is a 
proven product with over 3 years market 
presence and is offered by a company celebrating 
its 10th year in business. Now go build some 
help. 


Actual WYSrWYG editing environment shown here 
with the same compiled WinHelp file. 

Help Magician Pro is a good tool for quickly building 
help files in a graphical environment that also 
allows instant testing. 

Jim Powell . Windows Magazine 

... Certainly for Windows programmers it's 
indispensable. 

Neil Rubenking, PC Magazine 


Software Interphase, Inc. 

82 Cucumber Hill Road, #213 
Foster, Rl 02825-1212 
Tech: (401)397-2340 
Fax: (401)397-6814 
CompuServe: 70312,2707 
http://www.sinterphase.com 


Low Cost, Rich in 

* Self-contained WYSIWYG 
environment simulates WinHelp 

* Easy to use WinHelp Editor with spell 
checker- does not require Word or RTF 
codes 

* Import document files from Word, Ami 
Pro, or WordPerfect- including bitmaps! 

* Converts documents to help 

* Powerful multi-file/multi-author WinHelp 
Project Management™ for team 
development on a network 

* Simultaneous test mode with live 
hypertext links, browse sequences, and 
back button 

* Easily include multimedia audio, video, 
and animation in your help files 

* Supports many graphic file formats 

* Built-in glossary creation 

* Built-in screen capture utility 

* Creates help file shell from Visual Basic 
or Visual C programs 

* Graphical topic navigator 

* Fool-proof macro editor guides you in 
creating WinHelp macros 

* Supports ANY Windows development 
language or use it stand-alone 

* Includes Help Compilers 

* Free technical support and 30-day 
money-back guarantee 

* Works with Windows 3.x, WFW, 
Windows NT, and Windows 95 
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(single user license price quoted below) 
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7. Attack the future. 

The book is at its best in describing 
the insular, homegrown Microsoft man¬ 
agement structure. This is the only 
helpful explanation I've seen to date of 
Microsoft's nebulous title of "program 
manager." If your company has any 
technical relationship with Microsoft, 
this description alone is worth the price 
of the book. The authors also provide a 
lot of historical information on how 
Microsoft practices have changed with 
time, usually in response to serious fail¬ 
ures. When a company represents as 
large a percentage of an industry as 
Microsoft does of the PC software 
industry, understanding how it works 
(or even how it thinks it works) is worth 
the time it takes to read a book, and this 
book does a good job at delivering that 
understanding. 

The book is not at its best when it 
diverges from simple reportage. The 
authors emphasize the unique access 
they had to Microsoft personnel and 
they claim that Microsoft revealed 
many of its "innermost secrets"? That's 
just silly — Microsoft revealed little 
information of importance here that 
was previously unknown. The authors 
also take pains to establish the fact that 
Microsoft did not have any editorial 
control over the book. That point is also 
much ado about nothing — I can't see 
very much in this book that would 
change if Microsoft Marketing had been 
allowed to perform the final edit. The 
authors are deeply uncritical of 
Microsoft, and they seem to have 
accepted whatever information 
Microsoft chose to hand them without 
doing much in the way of corrobora¬ 
tion. 

The authors' lack of critical thought 
does not necessarily detract from their 
explanation of how Microsoft does 
business, but it does make their techni¬ 
cal descriptions of how Microsoft 
writes code appear breathtakingly 
naive. At every turn, Microsoft's redis¬ 
covery of trivial or decades-old pro¬ 
gramming practices is made to seem 
new and important. For example, the 
authors reveal that when a Microsoft 
developer checks in code that breaks 
the build, that developer must fix the 
defect immediately. What, exactly, do 
these professors think every other pro¬ 
gramming shop in the world does in 


that situation? They go on to claim that 
this innovative practice "actually 
resembles Toyota's famous production 
system, where factory workers stop the 
manufacturing lines whenever they 
notice a defect in a car they are assem¬ 
bling." A better analogy would be an 
automotive factory where workers are 
allowed to stop the lines whenever they 
notice that the cars are falling off the 
conveyer and killing people! If 
Microsoft programmers were allowed 
to "stop the lines" whenever they 
noticed a defect, the lines would have 
been stopped since 1980. When Brad 
Silverberg says "I think I've seen more 
products fail because of cross-develop¬ 
ment than probably any other develop¬ 
ment technique," the authors, like Mr. 
Silverberg, seem to be ignorant of the 
counterexample of the embedded sys¬ 
tems industry, which makes extensive 
use of cross-development and has a 
rather better reputation for delivering 
quality software than Microsoft does. 

Accepting what Microsoft told them 
at face value not only meant making 
unimportant things sound important, it 
also meant that some descriptions of 
Microsoft practice are just plain wrong. 
When Bill Gates says (in stating that 
Microsoft uses a single main develop¬ 
ment language) "People can argue 
about which is the best development 
language, but we have one," the 
authors accept it without question. In 
fact, Microsoft makes important use of 
at least three languages: C, C++, and 
assembly language (believe it or not, 
the Windows 95 team is still writing 
assembly language that the NT team 
then has to rewrite in C). The book also 
tends to spend little time analyzing 
whether the "secrets" that work for 
Microsoft would work for anyone else. 
For example, the authors point out that 
Microsoft likes to get to market early 
with a "good enough" product and 
then refine it over time. However, 
what's "good enough" for the largest 
PC software developer in the world to 
grab market share is unlikely to be 
"good enough" for a smaller developer, 
or even a large developer who does not 
have the luxury of bundling the new 
application with every copy of the oper¬ 
ating system. 

The main problem with this book is 
its premise: the company that makes 


the most money from software must be 
using the best practices for building soft¬ 
ware. There really isn't a lot of hard evi¬ 
dence to show that Microsoft builds bet¬ 
ter software more efficiently than most 
software companies, and this book does 
not change that fact. Is the highest quali¬ 
ty software development really found at 
the companies with the highest profits? 
That has not been my experience. 

Much of the popular business book 
market, of which this book is a part, 
relies on the human desire to believe 
that success is predominantly depen¬ 
dent on skill and hard work. The alter¬ 
native, that success is often dependent 
on factors outside our control, such as 
luck and timing, is not a theme that will 
sell many books. This book does con¬ 
tain a decent amount of information on 
how Microsoft does business, and is 
worth reading for that reason alone. 
However, if you want to read this book 
because you think you will discover 
secrets that will allow your company to 
become as successful as Microsoft, well 
then I have some books on how to pick 
winning lottery numbers that I would 
like to sell you. 


Borland Delphi How-To: 

The Definitive 
Delphi Problem Solver 
Gary Frerking, 

Nathan Wallace, 

Wayne Niddery 
The Waite Group 
851 pages 

$39.95, includes CD 
1995 

ISBN 1-57169-019-0 

[Editor's note: this review was con¬ 
tributed by George Tylutki.] "This is not 
a 'dummies' book!" announce the 
authors in the Introduction. That is, 
"readers are expected to understand the 
basics of creating forms, adding new 
components, and linking components 
with code." If you are at least a mini¬ 
mally competent Delphi programmer, 
you will find this a very useful book. It 
contains 113 programming problems 
and solutions organized in 12 chapters: 
Forms, Standard Components, 
Documents and Text, Mouse and Menu, 
Graphics, Multimedia, Environment 
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and System, Peripherals, Database, 
OLE and DDE, The Polished 
Application, and Tips and Tricks. For 
each problem they give a brief descrip¬ 
tion of the techniques that will be used, 
provide the solution as a list of steps 
(form design, property values, and the 
required code), explain how it works, 
and include additional comments. 

Some of the problems are simple 
(determining free system resources, 
arranging icons on the desktop). Others 
necessitate sophisticated solutions (a 
dumb terminal; a multimedia HTML 
document display application; a multi¬ 
user, UNIX-like Chat utility; a config¬ 
urable toolbar) that require hundreds of 
lines of code. In between are problems 
that address such subjects as animating 
and fading graphics, dragging caption¬ 
less windows, customizing listboxes, 
scrolling portions of a dialog box, justi¬ 
fying text, searching a disk and much 
more. 

Almost every solution requires that 
several techniques be employed. For 
example, creating a customizable tool¬ 
bar (like Delphi's) addresses the "prob¬ 
lems" of deriving a new component 
(TDragSpeedButton from TSpeedButton), 
handling the various events associated 
with dragging, keeping a form on top 
(but not modal), animating graphics 
(drawing and erasing as a button is 
moved to and from a toolbar), drawing 
items in owner-drawn list boxes, and 
more. It's often possible to extrapolate 
from their solutions to your problem. 
Therefore, even if you have no interest 
in a particular subject, all of the chap¬ 
ters are worth reading, except Chapter 
9. Although the back cover claims "In- 
depth coverage of . . . databases," the 
solutions in this chapter require only 0 
to 10 lines of code. They demonstrate 
the power of Delphi's data-aware com¬ 
ponents, but obviously aren't very com¬ 
plex. 

The code is well-written and easy-to- 
follow. When appropriate, comments 
are included at the proper place (rather 
than deferring explanation to the "How 
It Works" section). The writing is lucid 
and unadorned by anecdote and friend¬ 
ly chitchat. The explanations are all ade¬ 
quate, although there are a few places 
where more detail would be useful. 

There are pages and pages of list¬ 
ings; the code for every solution is 


included. You can, of course, load and 
compile the source code, use the debug¬ 
ger to trace through it, make changes, 
and so on. But you don't have to read 
this book while sitting at your comput¬ 
er; because the listings are complete, it 
can be used as a reference work. 
Further, the entire listing of each solu¬ 
tion is given. This means that when a 
solution builds on a previous one, all of 
the code is included again with the 
changes, deletions, and additions high¬ 
lighted. You can turn to any problem 
and find the complete solution; you 


HIGH-PERFORMANCE 

• high-throughput transaction model - 
supports group commit 

• asynchronous 10 

• advanced query optimizer - supports 
clustered index 

• SMP-ready out of the box 

• efficiently manages multi-gigabytes 
of data 

HIGHLY SCALABLE 

• small footprint, runs comfortably on 
desktop and laptop machines 

• offers true client/server capabilities 
in workgroup environments 

• capable of supporting departmental 
applications requiring fast response time 


don't have to search back through the 
book to find the implementation of a 
method or the declaration of a class. 

This is important because whenever 
possible the authors make part or all of 
a solution reusable, either by creating 
custom components or by placing pro¬ 
cedures, functions, and declarations in 
compiled units. For example, the last 
program of Chapter 6 (the complete 
multimedia, HTML document display 
application) is relatively short, because 
in previous solutions they have encap¬ 
sulated much of its functionality (play- 


ADVANCED STORAGE MANAGEMENT 

• file-based schemas are easy to set up 
and maintain 

• device-based schema provide greater 
control over physical storage management 

• on-line backup 

• media recovery 

EASE-OF-USE 

• easy to install 

• self tuned, DBA not needed for 
workgroup applications 

CONFORMS TO STANDARDS 

• entry level ANSI SQL '92 

• an ODBC level 2 driver, serving as a native 
API to the Quadbase engine, is included 


Prices start at $100 But don't be fooled by the low prices of Quadbase products. Quadbase-SQL 
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Quadbase-SQL is a trademark of Quadbase Systems Inc All other trademarks mentioned above are the property of their respective owners 
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Quadbase-SQL 4.0 is ideal for developers who build open 
client/server applications that require a DBMS which 
offers high-performance, robustness, ease-of-use, 
scalability, conformance to standards and low price. 
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VxD without burying the reader in 
Windows trivia and API references. This 
book is not for the beginner. These 
techniques require knowing assembly 
language, C, and DOS, especially direct 
calls to DOS using interrupt INT21. 

R&D Publications, 1995, 350 pp. 

ISBN 0-13-100181-7 

T59C with disk.$49.95 


WILLIAM SMITH 
ROBERT WARD 
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Windows Custom Controls 

By William Smith & Robert Ward 

This book demonstrates how to make 
powerful and usable custom controls for 
Microsoft Widows. The openness of the 
Windows programming environment 
allows the developer a wide range of 
options. Smith & Ward show how to 
exploit this creative opportunity with a 
modular technique that brings structure 
and reusability to Windows application 
designs. Reusing the custom controls 
allows you to focus on the larger design 
issues. 

R&D Publications, 1993, 531 pp. 

ISBN 0-13-034497-4 

W99S with disk.$55 



MS-DOS System Programming: 

Third edition 

Edited by David Burki & Robert Ward 

Veterans and beginners will all find 
something in this collection to save time 
and program MS-DOS more efficiently. 
Some otthe updated chapters include 
critical error handling, modifying the DOS 
boot, interrupt-driven serial I/O, TSRs, 
accessing the global environment, and 
interfacing to the floppy disk controller. 
New chapters include serial 
communications, the floating point 
coprocessor, CD-ROM drivers, Direct 
Memory Access, and the PC speaker. 
Each chapter gives complete details and 
can be read independently. The 
companion disk includes all the code. 

R&D Publications, 1994, 811 pp. 

ISBN 0-13-207382-X 





Building 

R*mot* Procedure Call* 
lor Window*' NT Network* 


RPC for NT 

By Guy Eddon 

RPC for NT shows how to harness the 
power of distributed computing on a PC 
network with a Windows NT server. Guy 
Eddon provides a step-by-step guide to 
developing Remote Procedure Calls. He 
explains standards and requirements, 
how RPC is related to other parts of 
Windows, and how to use RPC with 
parallel processors, multiprocessors, and 
transputers. Use RPC to solve problems 
in a fraction of the time it would take a 
single machine. 

R&D Publications, 1994, 427 pp. 

ISBN 0-13-100223-6 

T58C with disk.$39.95 


V36 with disk 


.$39.95 


You may FAX your order to 913-841-2624 or 
e-mail it to rdorders@rdpub.com 


All orders must be prepaid in US dollars by check, money order, 
or credit card—MasterCard, and VISA are accepted. 


FREE 1995 R&D Technical Book Catalog 

R&D publishes advanced programming books, as well as 
C/C++ Users Journal and Windows Developer’s Journal. 
Get your complete catalog of R&D programming books, 
along with descriptions of more than 150 useful books 
from a dozen different publishers. 

CALL TODAY — 913 - 841 - 1631 . 

Or, use the Reader Service card in this magazine. 

□ Request Reader Service #143 □ 
















































ing wave sounds, MIDI sequences, 
audio CDs, and video files, processing 
HTML tags, and so on) in custom com¬ 
ponents and units. 

There are typographical errors in the 
code (they appear to be limited to some 
kind of typesetting problem that caused 
= and <> to be occasionally dropped), 
but the code that I checked on the CD is 
correct. A "Message from the 
Publisher" indicates that program list¬ 
ings, errata sheets, and recent versions 
can be obtained from The Waite 
Group's Web site (I haven't verified 
this). Also on the CD are: demo versions 
of TurboPower's Orpheus and ASynch 
Professional and CIUPKC's FTL 2.1 
(hypertext, hypermedia components); 
two other programs not included in the 
book (an editor for putting HTML tags 
into text and a program that displays a 
device's capabilities); some freeware 
and shareware, including CGI and 
database components and data struc¬ 
tures (stacks, queues, etc.); and 105 AVI 
files (348 Mb). 

Because of the nature of the book, its 
index cannot be complete; there could¬ 
n't be an index entry to every page 
where, for example, a reference to "list- 
box" is made in the text or code. 
However, scanning the index, table of 
contents and screen shots should enable 
you to find what you want. 

The software license that accompa¬ 
nies the CD is standard: one computer, 
single backup copy, no decompiling, 
reverse engineering, or creating a deriv¬ 
ative work. No file on the CD contains 
additional copyright information. 
However, none of code in the book or 
on the CD contains a copyright notice 
and the book's back cover says it 
"includes source code and custom com¬ 
ponents that you can plug immediately 
into your own Delphi apps." It would 
be nice if the lawyers, publisher, edi¬ 
tors, and authors got together and con¬ 
structed a single, clear statement 
regarding the use of the code. 

This book is certainly not "The 
Definitive Delphi Problem Solver," but 
it can save you hours of on-line time 
searching for solutions to your prob¬ 
lems. Considering the amount of code 
included and its long-term usefulness, 
it's a bargain. 


Delphi Nuts & Bolts: 
For Experienced 
Programmers 
Gary Cornell and 
Troy Strain 

Osborne McGraw-Hill 
307 pages 
$24.95, no disk 



1995 

ISBN 0-07-882136-3 


[Editor's note: This review was pro¬ 
vided by George Tylutki.] Given the 
book's title and length, this might seem 
to be just what you have been looking 
for: a reasonably short introduction to 
Delphi aimed at you, "an experienced 
programmer." Maybe, but their defini¬ 
tion of the word "experienced" is one I 
am not familiar with. 

Their "experienced programmers" 
have to be told repeatedly that Alt+F4 
closes a window and that an active win¬ 
dow can be distinguished by its high¬ 
lighted title bar. Their readers need the 
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for C/C++ 
-Hut Version 7.0 (New) 

presents Bug # 1740 


1 

class S 

2 

< 

3 

char *p; 

4 

int *q; 

5 

unsigned n; 

6 

public: 

7 

S( unsigned k = 0 ) 

8 

t 

9 

n = k; 

10 

p = new char[n]; 

11 

q = new int[n] ; 

12 

> 

13 

-so { delete [] p; } 

14 

>; 


This class definition has a problem. Can you spot it? Call if you need a hint. 
Refer to Bug #1740. 


PC-lint for C/C++ will catch this and many 
other bugs. It will analyze a mixed suite of C 
and C++ modules to uncover bugs, glitches, 
quirks and inconsistencies. 

Version 7 of PC-lint breaks new ground with 
inter-statement value tracking for both 
automatic variables and class data members. 
Taking clues from assignment statements, 
initializei's and conditional expressions it can 
detect out-of-bound subscripts and potential 
null pointer uses. As an enabling technology, 
almost 100 standard functions are rigorously 
checked. Also macros are subject to increased 
scrutiny, checking for unparenthesized 
parameters, unparenthesized bodies and 
repeated arguments having side-effects. 

Plus Our Traditional C/C++ Warnings: 
Uninitialized variables, inherited non-virtual 
destructors, strong type mismatches, 


inadvertent name-hiding, suspicious 
expressions, etc., etc. 

Full C++ Support - PC-lint for C/C++ 
is based on the ARM and is tracking the 
latest ANSI/ISO draft including exceptions 
and templates. It supports both Borland and 
Microsoft C/C++. 

PC-lint for C/C++ $239 

Numerous compilers/ libraries supported. 
Runs on MS-DOS (Optional built-in 386 
DOS extender), OS/2, NT and Windows 95. 
This introductory price is effective through 
May 15, 1996. 

FlexeLint for C/C+ + 

The same great product for other operating 
systems. Runs on all Unix systems, VMS, 
mainframes, etc. Distributed in shrouded 
C source form. Call for pricing. 


PA add 6% sales tax. 


Gimps I Software 

3207 Hogarth Lane, Collegeville, PA 19426 

CALL TODAY (610) 584-4261 Or FAX (610) 584-4266 

30 Day Money-back Guarantee. 

PC-lint and FlexeLint are trademarks of Gimpel Software 


□ Fax #1082 □ 
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following clarification: “variable array (most people simply 
say 'an array')" (p. 135). In the Introduction, Cornell and 
Strain write, "We assume you have some programming expe¬ 
rience (what language really doesn't matter), and that con¬ 
cepts like loops and decision structures are familiar to you." 
But there are eight pages on for, repeat, and while loops and 
if -then-else and case statements. Twice they explain where 
the bar (" I") key is located on the keyboard (pp. 14 and 273). 

The first 78 pages are devoted to describing (with illustra¬ 
tions) Delphi's IDE (every menu and component-palette 
item), including detailed instructions about selecting, placing, 
sizing, and moving components. As late as page 258, they are 
still explaining what component palette buttons look like. 

However, detailed instructions aren't necessarily accurate 
instructions; in fact, there is a general lack of accuracy in this 
book. Clicking the Open Project button does not produce the 
same result as choosing Run on the File menu (p. 23). The 
description of dsDragLeave is incorrect (p. 284). Memo compo¬ 
nents cannot read and store 255K of text (p. 64). You can enter 
items into listboxes and comboboxes at design time (p. 66). 
Close does not remove a form from memory (unless the 
Action parameter is caFree) (p. 129). 64Kb is not 65,528 bytes 
(p. 147). The description of the "Strict Var-Strings" compiler 
option is backward (p. 166). There is no TCommand component, 
as they claim on page 183. Even conceptually, there are prob¬ 
lems: on page 122 they suggest using the InputBox function for 
obtaining passwords, but the text can't be masked. 

Much of this book is obviously derived from the Borland 
documentation. For example, the Visual Component Library 
Reference (and on-line help) says that when you call the 
Create constructor for components "if you don't want anoth¬ 
er component to own the created component, pass Self as the 
AOwner parameter" (p. 158). This is incorrrect, but on page 
186, Cornell and Strain simply repeat this information. In fact. 
Self refers to the object whose method is active. Thus, in 
MainForm.ButtonlClick, 

ANewButton := TButton.Create(Self) 

makes MainForm the owner of ANewButton. To prevent a com¬ 
ponent from having an owner (not a good idea), pass nil, not 
Sel f. Apparently, the authors never actually created a compo¬ 
nent and checked its Owner property. 

Also, detailed instructions aren't necessarily useful. On 
page 273, they say this about the Options property of the File 
Open and File Save common dialog boxes: "This property is 
used to set various possible options on how the box will look." 
And about the Ini tial Di r property they write: "Specifies the 
initial directory." 

The coverage of many topics is inconsistent and shallow: 
three pages on pointers and memory management, a one- 
page section called "Using the Windows API," 1.5 pages on 
goto, seven on DDE, seven on OLE, seven on graphics, two on 
MDI, seven on database programming, five on Windows com¬ 
mon dialogs, and one on PChars (all of the preceding include 
illustrations and tables). 

The book's standard copyright notice makes no mention of 
the code, but this is not a problem. The only "programs" are 
0- to 10-line programs. Excluding one-line examples, there are 


100, maybe 150, lines of code in the book. And even these are 
not always accurate and compileable. The errors include mis¬ 
placing semicolons and curly braces, missing begin/end pairs, 
using = instead of :=, setting a loop's initial value to 1 instead 
of 0, and failing to typecast when needed. 

The writing is unorganized, repetitious, and replete with 
grammatical errors and awkward phrases. Further, the 
authors fail to use terms precisely and consistently: the 
authors refer to an array as an object (p. 136) and a cursor as 
an icon (p. 282), and claim on page 262 that Pi xel S ( X, y ) lights 
up a pixel (it sets a pixel's color, which may light it up if it was 
previously set to black). The book is sprinkled with non 
sequiturs, such as "since Microsoft Windows is a graphical 
environment, the powers of Delphi in this arena are pretty 
spectacular" (pp. xvii and 257). 

Some people mistakenly believe that celery has negative 
nutritional value; that is, more energy is required to digest it 
than is derived from it. This is a celery book. You may know 
less after reading it, or doubt what you knew. The energy 
required to work your way through it will not be repaid in 
new or expanded knowledge. Delphi for Dummies is $6.00 
cheaper and contains lots of good code. Delphi Programming 
Explorer and Delphi Programming Unleashed, although more 
expensive ($39.55 and $45.00), are better written, near-com¬ 
prehensive introductory texts (with CDs). 


Windows NT Networking Programming 

Ralph Davis 

Addison-Wesley 

$39.95 

1994 

ISBN 0-201-62278-5 

[Editor's note: This book was reviewed by Paula 
Tomlinson.] Ralph Davis also wrote the earlier book, Windows 
Network Programming, in which he presented his own high- 
level network-independent interface for sending messages to 
remote machines. It was designed for Windows 3.1, when fun¬ 
damental network support in the operating system was weak 
and network interfaces for developers was even weaker. 
Windows for Workgroups added more network capability 
and Windows 95 was yet another improvement, but Windows 
NT (Workstation and Server versions) still has the richest net¬ 
working support of the Windows family. That very richness is 
what can leave developers in a daze; should I use Windows 
sockets, named pipes, mailslots, NetBIOS, or RPC for my 
application? 

Several general Win32 or Windows NT programming 
books touch on the Windows NT networking APIs and sever¬ 
al books focus exclusively on specific topics such as RPC. This 
is the only book I've seen so far that deals with network APIs 
in a comparable manner. There's some introductory level 
information on structured exception handling, memory man- 
agment, thread syncronization, file I/O and DLLs, but the 
majority of the book is specifically devoted to network issues. 
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While he does provide a general discussion of the major 
Windows NT networking APIs, the real premise of the book is 
to build up a set of general purpose, network-independent, 
peer-to-peer communication routines. This focus might not 
meet all readers' needs. For instance, readers specifically inter¬ 
ested in developing distributed applications might find this 
book an informative starting point but would probably want 
to continue with a book devoted exclusively to RPC. Also, the 
fact that he uses the WNet prefix for his own interface makes it 
a little bit hard at times to keep track of which routines are 
native to Windows NT and which are the author's creation. 

I give the author extra points for taking into account the 
fact that Windows NT runs on several different processors. 
He's careful about some of the obvious things, like the fact 
that the page size is not always 4Kb. The sample sources are 
also organized so that you can easily build binaries for multi¬ 
ple processor types based on a single shared volume contain¬ 
ing the sample sources. My impression is that he tested the 
samples on at least one Pentium and at least one of the alter¬ 
nate processors (a MIPS). He presents some benchmark com¬ 
parisons between various methods of network communica¬ 
tion that probably should be taken only as indications of 
trends but are useful none the less. Unfortunately the graphs 
in the book appear so grainy as to be difficult to read. 

I'm not quite sure I agree with his decision to write off 
Unicode and essentially stick with ANSI for his examples. He 
apparently based this decision on the fact that both the net¬ 
work APIs and the operating systems themselves (Windows 
3.1, Windows 95, and Windows NT) are inconsistent in their 
support of Unicode. Although there are major inconsistencies 
and using Unicode can be a pain, networked applications can 
potentially benefit the most from using Unicode due to 
Unicode's better mixed language support. Imagine writing a 
server database application that supported clients running 
several different language versions of Windows NT and 
Windows 95. I'd probably choose Unicode for such an appli¬ 
cation. 

I definitely recommend this book for anyone developing 
applications that are remotable or distributed or just plain 
need to communicate with remote machines or remote 
resources (such as a remote printer). If you're using something 
as complex as RPC, you'll want to look for additional, more 
exhaustive, reference information, however. 


Let's Talk Books 

Sb: VFP Book? 

Fm: Luis A. Espinal 72253,1133 
Hi Ron. 

A few days ( or weeks? ) ago I suggested a book for Visual 
FoxPro (VFP). If you have the time, take a look at the book 
Visual FoxPro Programming Basics, by Tom and Leonard 
Stearns, published by Osborne McGraw-Hill. It is not bulky, 
yet is very informative and clear. What is most important 
about this book is that rather than distracting (and confusing) 
the reader with descriptions of how pretty the programming 
environment is, it gives a good introduction to OOP as well as 
covering data normalization and referential integrity. So 
maybe when you have the chance and time to mention a book 
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for VFP, this one may be a good candidate. By the way, this 
book looks as if the writers have a college textbook in mind. 
Very cool! 

Thanks for the pointer! —rib 

Mr. Burk, 

Do you know of ANY good Win32 (and NT) books except 
for Richter's books? Richter is the only author I have found 
who has not just done a cut and paste from various Microsoft 
helpfiles, manuals, and screenshots. Just look at all the horri¬ 
ble C++ books: Black Belt C++, C++ of the Masters, Godzilla's 
C++ Cookbook, The Secrets of C++ Gurus. With titles like these, I 
wonder what the target age is, kids? I find it very difficult to 
take such books seriously. Generally, I think that the quality 
has gone down (while the quantity has skyrocketed) over the 
last few years. 

Adrian Pybus 
Omnitrade AB 
ap@omnitrade.se 

I recently read a chapter (on writing NT services) in Marshall 
Brain's Win32 System Services, and found it useful. I haven't 
studied the rest of the book, but you might want to check it out. I'm 
sorry to say that Richter's Advanced Windows is the only thing 
close to a general-purpose Win32 book that I would currently rec¬ 
ommend. However, I’ve got afeiv new ones in my stack to look at, so 
hope springs eternal. 
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I have to agree with you that quantity 
and quality of programming books have 
shot off in different directions. I wish I knew 
something we could do about it! —rib 

Books Received 

William Perry. Effective Methods for 
Software Testing. A Wiley-QED 
Publication — John Wiley & Sons, 
Inc., 1995. 539 pages. ISBN 0-471- 
06097-6. 

Grady Booch. Object Solutions: 
Managing the Object-Oriented Project. 
Addison-Wesley Publishing 

Company, Inc., 1996. 323 pages. 
ISBN 0-8053-0594-7. 

Zane Thomas, Karl Peterson, Constance 
Petersen, James Shields, Stuart 
Greenberg, Mitchell Waite. Visual 
Basic 4 How-To. Waite Group Press, 
1995. 1083 pages. $39.95. ISBN 1- 


57169-001-8. 

Stuart Bloom and Don Kiely. Visual 
Basic 4 Database How-To. Waite 
Group Press, 1995. 835 pages. $ 
36.95. ISBN 1-878739-94-8. 

Francois Fluckiger. Understanding 
Networked Multimedia Applications 
and Technology. Prentice Hall, 1995. 
620 pages. ISBN 0-13-190992-4. 

Howard W. Johnson. Fast Ethernet Dawn 
of a New Network. Prentice Hall, 1996. 
310 pages. ISBN 0-13-352643-7. 

Martin De Prycker. Asynchronous 
Transfer Mode Solution for Broadband 
ISDN, 3rd Ed. Prentice Hall, 1995. 
380 pages. ISBN 0-13-342171-6. 

The ATM Forum Technical Committee. 
User-Network Interface (UNI) 


Specifications 3.1. Prentice Hall PTR, 
1995. 396 pages. ISBN 0-13-393828-X. 

William J. Beyda. Data Communications 
From Basics To Broadband, 2nd Ed. 
Prentice Hall, 1996. 311 pages. ISBN 
0-13-366923-8. 

Gary Cornell and Troy Strain. Visual 
Basic 4 Nuts & Bolts for Experienced 
Programmers. Osborne McGraw-Hill, 
1995.338 pages. ISBN 0-07-882141-X. 

Peter Wright. The Beginner's Guide to 
Visual Basic 4.0. WROX Press Ltd., 
1995. 898 pages. $34.95. ISBN 1- 
874416-55-9. 

Saba Zamir. C++ Primer for Non C 
Programmers. McGraw-Hill, Inc., 
1995. 331 pages. $34.95. ISBN 0-07- 
072704-X. □ 


Windows 

□ DEVELOPER'S JOURNAL 

The Magazine for Windows Programmers 


Windows Developer’s Journal buys dozens of articles each year 
from readers like you. You don’t have to be a writer, but you do 
have to have a concrete topic of interest to other Windows pro¬ 
grammers. Most of the articles we use are built around short 
(100-300 lines), reusable code that solves specific problems of 
interest to Windows programmers. We are especially interest¬ 
ed in Visual Basic article proposals at this time. The easiest 
way to propose an article topic is to send email about your idea 


Call for Papers 

to the editor, Ron Burk, via CompuServe at 70302,2566 or 
Internet at 70302.2566@compuserve.com. Make sure you 
include an estimate of the number of lines of code involved. 

If you don’t have access to email, you can fax your proposal to: 
Managing Editor, Windows Developer’s Journal, (913) 841-2624, or 
mail it to: Managing Editor, Windows Developer’s Journal, 1601 
West 23rd St., Suite 200, Lawrence, KS 66046-2700. 

(913) 841-1631; FAX (913) 841-2624. 


C++ 

■ Proposals due 15 Feb 1996 
manuscripts due 15 Mar 1996 

Suggested Topics: A benchmark 
that compares the speed of C++’s 
stream I/O to normal C I/O functions. 
A simple filter to turn your C++ com¬ 
ments into a WinHelp file. A guide to 
writing vendor-independent Windows 
C++ code. Tips for applying the new 
Standard Template Library to 
Windows Programmings. 


Software Tools 

■ Proposals due 15 Mar 1996 
manuscripts due 15 Apr 1996 

Suggested topics: A tool that gen¬ 
erates .hip files from source code 
comments. A filter that locates source 
code that may work on Win95 but not 
NT, or vice versa. A grep that works 
on OLE compound files. 


Visual Programming 

■ Proposals due 15 Apr 1996 
manuscripts due 15 May 1996 
Suggested topics: Enhancing the 
VB4 listview control. A reusable func¬ 
tion for adding your app to the system 
“tray.” A Delphi treeview control with 
automatic structured storage backup. 
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Understanding NT 


The Registry 

Paula Tomlinson 


Windows 95, like Windows NT, uses the registry exten¬ 
sively for storing configuration information. While both oper¬ 
ating systems store some standard information in exactly the 
same location (registry key) and format (value name and 
type), they store other common information under different 
registry locations. Another incompatibility exists between the 
Windows 95 and Windows NT implementation of the registry 
support itself. The incompatibility is also present in how the 
registry is presented to developers, in the form of the Win32 
registry API. If you're trying to write software that works cor¬ 
rectly with both Windows 95 and NT, the registry is a likely 
source of problems. This column will outline the differences in 
using the Windows 95 and NT registries, and help you write 
code that works well with both operating systems. 

General Registry Notes 

Before diving into registry differences between the two 
operating systems, I want to review some general points 
about the registry that programmers often forget or ignore. 
First, Microsoft reserves the right to change the registry loca¬ 
tion of any operating system specific information, so you 
should not hardcode registry locations. In most cases, if you 
need to get some operating system information from the reg¬ 
istry, then you can find a suitable system routine to retrieve it. 
If you choose to hardcode registry locations, then be prepared 
to verify that your code still works on each new version of the 
operating system, and certainly test your code on both 
Windows 95 and Windows NT. 

It's also worth reviewing the convention for storing appli¬ 
cation data in the registry. Applications should store their 
global data under: 


HKEY_LOCAL_MACHINE 
Software 
VendorName 

ApplicationName 
Version 

User-specific data (settings that may vary depending on what 
user account is logged on) should be stored under: 

HKEY_CURRENT_USER 

Software 

VendorName 

ApplicationName 
Version 

A common gotcha in using the Win32 registry functions 
crops up as a result of the way they handle errors. Here's a typ¬ 
ical example, demonstrated by a question posted recently on 
CompuServe by Bill Somerville. Bill was apparently attempting 
to open HKEY_LOCAL_MACHINE\SECURITY, which he knew was a 
secured registry key. His call to open the key failed as expected, 
but when he called GetLastError () it returned 
ERROR_ALREADY_EXISTS instead of ERROR_ACCESS_DENIED. What 
went wrong? 

The problem is that the registry routines do not return a 
Boolean TRUE or FALSE, like many of the other Win32 routines; 
instead, they return a Win32 error value directly. In fact, if you 
check the code returned directly from RegOpen Key Ex () (as 
opposed to calling GetLastError ()) when attempting to open 
the HKEY_LOCAL_MACHINE\SECURITY key, it does return error code 
5, which is ERR0R_ACC ESS_DEN I ED — exactly what you would 
expect. The call to GetLastErrorf ) just returns whatever error 
code was last encountered by the calling thread. This error 
code persists until some other Win32 routine overwrites it 

continued on page 66 


Paula Tomlinson has been developing DOS, Windows, and Windows-NT based applications and device drivers for eight years. The opin¬ 
ions expressed here are hers alone. She can be contacted via the Internet at pauT at@mi crosof t. com. 
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Advertiser Index 


You can now get additional information about 
products and services you see advertised four way si 


Contact the vendor directly using the 
information in the advertisement.. 



wdrs@rdpub.com 


© Email your request to 

wdrs@rdpub.com. Make sure you 
include the magazine's issue 
number (7.3) and where you would 
like the information sent. 


© Fill in the Reader Service number 
found under the ad or in this index 
on the bound-in Reader Service 
Response Card. Provide the 
requested contact information 
(subscribers can simply attach their 
mailing label), then mail or 
fax (913-841-2624) the card back to us. 


m 



800-234-0141 


O Use the Instantlnfo FAX response 
service. For immediate information, 
call 800-234-0114 and request 
the Instantlnfo number listed below 
the ad or in this index. 

The information is sent to the FAX 
machine of your choice. 
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continued from page 63 

with another value. Because the registry routines directly 
returns an error code, many (if not all) of the registry API rou¬ 
tines do not set the last error when an error is encountered. It's 
important to look at the return value and not rely on 
GetlastErrorO when using the registry routines. 

No Security On Win95 

In Table 1, I've listed all the Win32 registry routines, includ¬ 
ing the original 16-bit Windows 3.x registry routines that now 
exist solely for backward compatibility. Since Windows 95 
does not provide the same internal security mechanisms that 
Windows NT does, it should come as no surprise that 
RegGetSecuri tyKey () and RegSetSecurityKey () are supported 
only on Windows NT. The absence of security support on 
Windows 95 also impacts RegCreateKeyEx(), 
RegQuery InfoKey (), and RegSaveKey( ). These routines all have 
a parameter that accepts or returns SECURITY_ATTRI BUTES infor¬ 
mation on Windows NT but is ignored on Windows 95. 

The moral here is that you can't rely on security settings on 
registry keys to prevent unexpected access to sensitive infor¬ 
mation if your code will be running on both Windows NT and 
Windows 95. Likewise, just because you can access a registry 
key on Windows 95 does not mean that you can access that 
same key under Windows NT. On Windows NT, a given reg¬ 


Table 1 The Windows Registry API 

Registry Routine 

Windows NT 

Windows 95 

RegCloseKey 

Yes 

Yes 

RegConnectRegistry 

Yes 

Yes 

RegCreateKey 

Yes 

Yes 

RegCreateKeyEx 

Yes 

Yes 

RegDeleteKey 

Yes 

Yes 

RegDelete Value 

Yes 

Yes 

RegEnumKey 

Yes 

Yes 

RegEnumKeyEx 

Yes 

Yes 

RegEnumValue 

Yes 

Yes 

RegFlushKey 

Yes 

Yes 

RegGetKeySecurity 

Yes 

No 

RegLoadKey 

Yes 

Yes 

RegNotifyChangeKeyValue 

Yes 

No 

RegOpenKey 

Yes 

Yes 

RegOpenKeyEx 

Yes 

Yes 

RegQuery InfoKey 

Yes 

Yes 

RegQueryValue 

Yes 

Yes 

RegQueryValueEx 

Yes 

Yes 

RegReplaceKey 

Yes 

Yes 

RegRestoreKey 

Yes 

No 

RegSaveKey 

Yes 

Yes 

RegSetKeySecurity 

Yes 

No 

RegSetValue 

Yes 

Yes 

RegSetValueEx 

Yes 

Yes 

RegUnLoadKey 

Yes 

Yes 


istry key may have security attributes that prevent some logon 
accounts from accessing it. The SECURITY key under 
HKEY_LOCAL_MACH INE is an example of a registry key with very 
restrictive security under Windows NT. 

No Volatile Keys Under Win95 

Windows NT also supports the notion of volatile and non¬ 
volatile registry keys. You specify this attribute when you cre¬ 
ate a registry key using RegCreateKeyExt ). A volatile registry 
key is automatically purged from the registry when the sys¬ 
tem shuts down. Windows 95 ignores volatility setting when 
RegCreateKeyEx( ) is called. A careless application might store 
temporary information in volatile registry keys, relying on 
automatic deletion of this information at the next shutdown. 
On Windows 95, this same application will permanently store 
extra registry information, so it could easily clutter up the reg¬ 
istry and waste disk space. 

No Class Names Under Win95 

RegCreateKeyEx( ) allows you to specify a "class name" 
when you create a registry key. The documentation is not clear 
on the intended use of this parameter, but it appears to be an 
arbitrary string that you can associate with any registry key. 
All you can do with the class name is set it when you create 
the key and query it later with RegQuery I nf oKey (). Presumably 
you could use this string to create your own convention for 
handling registry data; e.g., you could label some registry 
keys with the class name "date," check the class name when 


Figure 1 Code to delete subkeys under NT 


BOOL RegDeleteNode(HKEY hParentKey, LPCTSTR szKey) 

1 

ULONG ulSize - 0; 

LONG RegStatus - ERR0R_SUCCESS; 

HKEY hKey = NULL; 

TCHAR szSubKey[MAX_PATH]; 

// attempt to delete the key 

if (RegDeleteKey(hParentKey, szKey) !- ERRORJUCCESS) ( 

RegStatus - RegOpenKeyExthParentKey, szKey, 0, 
KEY_ALL_ACCESS, ShKey); 

// enumerate subkeys and delete those nodes 
while (RegStatus -= ERRORJUCCESS) { 

// enumerate subkeys directly under the current 
// key (always use index 0, registry enumeration 
// looses track when a key is added or deleted) 
ulSize - MAXJATH * sizeof(TCHAR); 

RegStatus - RegEnumKeyEx(hKey, 0, szSubKey, 
JulSize, NULL, NULL, NULL, NULL); 

if (RegStatus -- ERRORJUCCESS) { 

RegDeleteNodethKey, szSubKey); 

1 

1 

// try deleting the top level key again 
RegCloseKey(hKey); 

RegDeleteKey(hParentKey, szKey); 

1 

return TRUE; 

} // RegDeleteNode 
/* End of File */ 
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displaying registry data to the user, and in the case of class 
"date," format the data as a date. 

Unfortunately, the Win95 SDK documentation does not 
point out that Win95 ignores class names. If you pass a class 
name to RegCreateKeyExl ), the function does not fail, but when 
you later call RegQuerylnfoKeyf ) to query the class name, it just 
returns a NULL. Probably few people are making use of registry 
key class names under NT, but anyone porting class names to 
Win95 will likely get caught by this undocumented behavior. 

Predefined Registry Keys 

Both Windows NT and Windows 95 support the follow¬ 
ing predefined base registry keys: HKEY_CLASSES_ROOT, 
HKEY_CURRENT_USER, HKEY_LOCAL_MACHINE, and HKEY_CURRENT_USER. 
I checked several different versions of the Win32 online refer¬ 
ence and didn't see any mention of the two additional prede¬ 
fined keys Windows 95 supports: HKEY_CURRENT_CONFIG and 
HKEY_DYN_DATA. The HKEY_DYN_DATA key is used as a mechanism 
for VxDs to communicate with Windows 95 applications and is 
thus not supported on Windows NT. The HKEY_CURRENT_CONFIG 
key is used to store information on a hardware profile specific 
basis. Hardware profiles are part of Plug and Play support and 
are most commonly used to distinguish between the docked 
and undocked states of dockable notebook computers. Plug 
and Play support, including the HKEY_CURRENT_CONFIG key, is not 
available in Windows NT Version 3.51, but is expected in a 
future version of Windows NT. 


Remote Registry Problems 

The Win32 registry routines are remotable to other 
machines via the RegConnectRegi stry( ) routine. When you 
call RegConnectRegistry( ), you specify a machine name and 
either HKEYJSERS or HKEY_LOCAL_MACHINE (HKEY_CURRENT_USER 
and HKEY_CLASSES_ROOT are not allowed.) You can use the reg¬ 
istry handle returned to access registry information on the 
specified machine. Of course, you must have permission to 
access that machine first. Although RegConnectRegi stry( ) is 
supported on both Windows 95 and Windows NT, it cannot be 
used to connect from a Windows 95 machine to a Windows 
NT machine or vice versa. If you want to use 
RegConnectRegi stry( ), both machines have to be running the 
same operating system. On Windows 95, you must also 
ensure that remote administration is enabled on the target 
machine (via the Passwords applet) and that both the target 
machine and the machine that RegConnectRegi stry( ) is called 
from are running the remote registry service. 

NULL Termination Incompatibility 

The original 16-bit registry only allowed storing a single 
unnamed value under a registry key. The type of data for this 
value was assumed to be a null-terminated string. 
RegSetValueO is still supported on Windows NT and 
Windows 95 for compatibility, but it has been replaced by 
RegSetValueEx(). RegSetValueEx( ) allows you to store multi¬ 
ple named pieces of data under a registry key. You can think 
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of registry keys as being sort of like directories and registry 
values as being like files. Each registry value has a name by 
which it is referenced and has actual data associated with the 
value. This data also has a type, which can be one of the fol¬ 
lowing: REG_BINARY, REG_DW0RD, REG_DWORD_BIG_ENDI AN, 
REG_DWORD_LITTLE_ENDIAN, REG_EXPAND_SZ, REG_LINK, 
REG_MULTI_SZ, REGJONE, REG_RESOURCE_LIST, REG_SZ. 

The registry code itself essentially ignores this type infor¬ 
mation. This type information is stored just so applications 
that query the data can decide how to interpret it. It's impor¬ 
tant to understand that the registry code treats the informa¬ 
tion you store there simply as raw binary data. It's entirely 
up to the application whether to use the type attribute as a 
hint or ignore it completely. An example of this shows up 
when comparing the Windows NT registry viewer 
(regedt32.exe) and the Windows 95 viewer (regedit.exe). 
When you edit a value using regedt32 (on Windows NT), it 
displays the data in a format appropriate to the data's type. 
This feature is very convenient when you're editing a com¬ 
plex data type, such as a REG_MULTI_SZ (a list of strings sepa¬ 
rated by a single null terminator and two null terminators at 
the end). By contrast, regedit.exe (on Windows 95) treats 
anything other than REG_SZ as simple binary data. 

In at least one important exception, Windows 95 does not 
ignore the data type. Consider the following code fragment 
(TEXT() and TCHAR are macros that expand differently depend¬ 
ing on whether you're compiling for Unicode): 


Prolndex 



Full-Text Indexing and Retrieval 
Development Toolkit! 


Portable 


( 

Powerful 

Unlimited document size and quantity 
Full control of document parsing 
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Phrase, Proximity 
Paraphrase, Delimited Search 
Multi-level nested expressions 

Dynamic 
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Simultaneous indexing and retrieval 

Efficient index base tuning 


DOS, Windows (3.1, NT, 95), 

OS/2, Macintosh, NeXT, Unix 
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Unequaled indexing speed 
Fast complex searches 
Find the EXACT location of a search 
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lstrcpytszString, TEXT(“Test”)); 

RegSetValueExChKey, TEXT(“ValueName”), 0, 

REG_SZ, (LPBYTE)szString, 

1strlen(szString)*sizeof(TCHAR)); 

The documentation for RegSetVal ueEx () specifies that the last 
parameter should contain the total size in bytes of the data 
passed in the preceding parameter. This size includes the NULL 
terminator character if the data is a REG_SZ. In my code frag¬ 
ment, I've made the common mistake of not adding room for 
the null terminator, so I've effectively truncated the string 
right after the "t". If I only test this code on Windows 95 I 
might never catch this bug because Windows 95 politely 
appends a NULL terminator if you give it REG_SZ data that is not 
already NULL terminated. When I call RegQueryValueEx( ) to 
return the information I just set, I will get back a NULL-termi¬ 
nated string and a size of 5 (assuming ANSI character set) 
instead of the size of 4 that I passed in. 

RegQueryValueEx(hKey, TEXT(“ValueName”), 

NULL, &ulType, (LPBYTE)szString, &u1S i ze); 

What's wrong with that? The problem is that Windows NT is 
very precise about RegSetVal ueEx( ) and will not append the 
NULL terminator on my behalf. So on Windows NT, the pre¬ 
ceding code fragments will store a string with no NULL ter¬ 
minator and return this un-terminated string when I query the 
value. If I then pass this data on to something as harmless as 
IstrcpyO, I may get an access violation because IstrcpyO 
won't be able to find the end of the string. This might seem 
like a minor detail, but I've witnessed code very much like the 
above that worked fine on Windows 95 and didn't work at all 
on Windows NT. Note that Windows 95 will not append extra 
NULL terminators on the complex string types (REG_MULTI_SZ 
and REG_EXPAND_SZ) since it treats those types as binary data. 

Another inconsistency I stumbled across concerning NULL 
terminators on strings involves RegQueryInfoKey (). If you're 
enumerating keys and values that can vary in size, 
RegQueryInfoKey( ) becomes amazingly useful. Among many 
other things, this routine tells you the length of the longest sub¬ 
key under the specified key. On Windows NT, this length does 
not include the null terminator but on Windows 95 it does. 

RegDeleteKeyO 

The Win32 on-line reference clearly documents that 
RegDeleteKeyO will delete the specified key and any subkeys 
on Windows 95 but will fail if the specified key has any subkeys 
on Windows NT. Even though this is documented, it is worth 
mentioning, since the behavior is so different between the two 
operating systems. To make my code work on both Windows 
NT and Windows 95,1 replace any calls to RegDel eteKey () with 
my own RegDel eteNodeO, shown in Figure 1. 

The first thing RegDel eteNodet ) does is call RegDel eteKey (), 
which will succeed if there are no subkeys or if it's running on 
Windows 95. If RegDel eteKey () fails, RegDel eteNode () assumes 
there are subkeys that must be deleted first, so it opens the 
parent registry key and enumerate its subkeys. For each of 
these subkeys, RegDel eteNode( ) calls itself recursively to 
delete any subkeys of this key. This recursion process will 
work its way to the button of each leaf in the registry and 
delete from the bottom up. Note that I have to start the enu- 
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meration over each time by specifying 
an enumeration index of zero. 

RegEnumKeyExf ) behaves unpredictably 
if you add or delete keys while you are 
enumerating them. After all the sub¬ 
keys have been deleted, 

RegDeleteNodel ) tries again to delete 
the original key. 

Only on Windows NT 

In addition to the two security-relat¬ 
ed registry routines 

(RegGetKeySecuri ty () and 

RegSetKeySecurityl )), 

RegNotifyChangeKeyVal ue( ) is another 
extremely useful registry routine that is 
at this point only available on Windows 
NT. With RegNoti fyChangeKeyVal ue(), 
an application can specify a registry key 
(and optionally its subkeys), a filter 
parameter, and an event handle. The fil¬ 
ter parameter indicates which types of 
registry changes to the specified reg¬ 
istry key you want to be informed 
about. When such a change occurs, 

Windows NT signals the event handle 
you specified. 

Windows NT provides registry func¬ 
tions that let you save part of the registry 
tree to a file, or restore part of the tree that was saved to a file 
back to the registry. Contrary to popular belief, Windows 95 
supports all but one of the file- based registry operations sup¬ 
ported on Windows NT. Specifically, Windows 95 supports 
RegLoadKey, RegUnLoadKey, RegSaveKey, and RegReplaceKey. 
These routines are a bit more difficult to use on Windows NT, 
since they require the calling process to have special privileges. 
The one registry save and restore type routine not supported on 
Windows 95 is RegRestoreKey (). The RegSaveKey () and 
RegRestoreKey( ) can be very convenient for moving informa¬ 
tion around in the registry that has several layers of subkeys. 
They can also be used by an installation program to load pre¬ 
defined information in the registry. Since RegSaveKeyO and 
RegRestoreKey () are usually used together on Windows NT, I 
have no idea why only RegSaveKeyO is implemented on 
Windows 95. 

Summary 

There are subtle and not so subtle differences between the 
registry routines on Windows NT and Windows 95. If you 
know that your code will only be running on Windows NT, 
you can take advantage of features such as volatile registry 
keys, security, and registry change notification. On the other 
hand, if you think there's even a chance your code might run 
on Windows NT and Windows 95, then I hope I've demon¬ 
strated the necessity of testing on both operating systems. 

I'm sure this is not a complete list of the differences 
between the Windows NT and Windows 95 registry routines. 
If you've discovered other differences, please send them to me 
and I'll share them with the other readers. I'll also be demon¬ 
strating some of the special "NT Only" features of the registry 
in a future column. O 
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Windows Bug of the Month 

Roger Alley 


This month's bug comes courtesy of Thor Ivar Ekle, who 
has determined that certain USER functions (USER is the 
Windows DLL that contains most user interface API func¬ 
tions) in Windows 95 assume that the direction flag must be 
clear. As Thor properly states, it has always been standard 
programming practice to assume one does not know the cur¬ 
rent state of this flag, and to set or clear the flag explicitly 
whenever it's needed. Apparently Microsoft has decided, with 
Windows 95, to forgo this practice and simply require that the 
flag always be clear. 

For those of you who don't know what the direction flag is, 
it's tied to the set of 80x86 instructions collectively referred to 
as the string instructions. These instructions simplify loading 
(e.g., 1 odsb), storing (stosb), moving (movsb), scanning (scasb), 
and comparing (cmpsb) sequential bytes, words (lodsw), or 
double words (lodsd). In addition, the 80x86 has a group of 
special instructions, referred to as rep, which can be pre-pend- 
ed to a string instruction to allow the instruction to be repeat¬ 
ed a number of times, or until some condition is met. 

The string instruction opcodes are very short (a single byte, 
in fact), which makes them useful for writing small code. To 
accomplish this, however, they implicitly use certain registers 
(normally dS: Si and/or es: di, and CX for the loop counter), 
which must be set up prior to executing the string instruction. 
For example, the following code would copy 200 bytes from 
ds : 400 through ds:5FF to ds : 600: 


mov 

si ,0400h 

push 

ds 

pop 

es 

mov 

di ,0600h 

mov 

cx,0200h 

rep 

movsb 


;set ds:si to ds:400 (hex) 
;set es:di to ds:600 


;number of bytes to move 
;copy 200h bytes from 
;ds:si to es:di 


Actually, there's a problem here. This code will, in fact, copy 
200 bytes from ds: 400 through ds: 5FF, but only if the direction 
flag is clear. This flag is a signal to the CPU to increment the 
implicit registers (s i and d i) after each byte has been copied. 
If the direction flag was set instead, the code would start by 
copying the bytes at ds: 400 to ds: 600, but then would decre¬ 
ment si and di, so the next byte copied would be from ds: 3FF 
to ds: 5FF. For the code to do what I intended, I must add a 
cl d instruction, somewhere prior to the rep movsb, to clear the 
direction flag and thereby inform the CPU to move forward. 
Some of the code in Windows 95, however, apparently thinks 
this cl d is unnecessary. 

In truth, the direction flag is most useful when it's clear; 
most code containing repeated string instructions wants to 
move forward in memory, not backward. One common excep¬ 
tion to this arises when copying an overlapping range of 
memory. For example, you can't use the forward direction to 
copy the bytes at 200h through 3FFh to 300h. If you try to do 
this, the processor will copy the first lOOh bytes properly, but 
when it tries to copy the bytes from 300h through 3FFh to 400h, 


Roger Alley is a contract programmer working in the Bay Area. He can be reached via CompuServe at 71163,2407. 
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it finds that those bytes have already been changed! The nor¬ 
mal way to get around this is to position the pointers at the 
end of the strings (in this case, 3FFh and 4FFh), and then set the 
direction flag (via the Std instruction) and copy the bytes 
backward. This will produce the correct results. 

In DOS and Windows programming, the convention has 
always been that you are responsible for clearing or setting the 
direction flag before you execute any repeated string instruc¬ 
tion. According to this convention, you should never assume 
the direction flag is in a particular state. Windows 95 changes 
that — it apparently assumes that the direction flag will 
always be left clear. If you leave the direction flag set, the 
potential is high that the system will soon hang. 

With Softlce for Windows 95 in hand, I tried to find the 
exact location of this bug, 
but I soon realized that it 
does not occur in a single 
location. I put together a 
simple skeleton program, 
which did nothing but 
create a main window 
with a small menu, and 
stuck an std instruction 
(which sets the direction 
flag) in front of the switch 
statement in the main 
window handler. With 
this extra statement 
included, definite prob¬ 
lems showed up with the 
WM_NCPAINT message (the 
menu wouldn't draw), as 
well as other problems 
with some key and 
mouse messages. When 
the system hung, it was 
most often because of 
some type of fault in 
USER'S GetMessage32() 
function. Presumably this 
was because some prior 
function had over-written 
some piece of data (by 
doing an unintentional 
backwards copy) which 
the system as a whole 
relied on. 

I tried the above pro¬ 
gram on Windows 95 
with both a 16-bit and a 
32-bit executable, and 
obtained identical results. 

Thus, this problem is not 
confined to just the 
Windows 95 16-bit sub¬ 
system. Microsoft pub¬ 
lishes a book called 
Programmer's Guide to 
Microsoft Windows 95, 


which contains an article entitled "Version Differences"; that 
article lists differences between Windows 3.1 and Windows 
95, but does not mention that Windows 95 assumes the direc¬ 
tion flag will be kept cleared. 

My guess is that this change was not intentional, but 
instead is simply the result of sloppy programming, or per¬ 
haps a faulty compiler. In any event, be aware that when pro¬ 
gramming for Windows 95, it is no longer acceptable to set the 
direction flag and then leave it in that state. You must clear it 
once you're through with it. 

If you've uncovered a Windows 95 bug, why not share it 
with other Windows programmers? Send your bug to me at 
71163.2407@compuserve.com. □ 
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IsWindow Quickjnfo Overview Group 


#The IsWindow function determines whether the 
specified window handle identifies an existing window. 


: Annotate 


Current annotation: 


The documentation claims this function 
returns TRUE if the given handle is a valid 
window handle. That was true under 
Windows 3.x and is true under Windows 
NT, but Windows 95 returns a large 
non-zero value that is not equal to 1 (nor is 
it equal to the window handle). In an 
un-indexed help topic in the initial Win95 
SDK, Microsoft reveals that Win95 
functions with BOOL return types are only 
guaranteed to return non-zero when the 
documentation claims they return TRUE. 

Submitted by: David Lowndes 
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OpenExchange Facilitates Data Import/Export 


The OpenExchange DLL is a 145Kb library that 
allows programmers to read and write spreadsheet 
and database files in popular formats without the 
overhead of DDE or OLE. You can use this DLL, for 
example, to read and write Excel files even when 
Excel is not present. Formats supported include Excel 
v2.1-v5.0, Lotus 1-2-3 vl.0-v5.0, Quattro Pro vl.0-v6.0. 
Symphony, Paradox v3.x-v5.0, and dBase II, II, and 


IV. You can use the library to move data to or from 
memory, or directly from one file to another. 

The OpenExchange Developer's Kit v2.0 costs $495, 
or $795 for a royalty-free version. The OpenExchange 
DLL costs $295. For more information, contact 
Innovative Solutions & Technologies, 904 Jefferson 
Ave., Joplin, MO 64801, (800) 962-4855 or (417) 781- 
3282; fax (417) 781-3299; 74777.2651@compuserve.com. 


Comment++ Provides $29.95 Comment Scripting 


Comment++ is a new add-on tool for Visual C++, 
Visual Basic, Borland C++, Delphi, Symantec C++, or 
CodeWright. Comment++ helps automate the 
process of commenting code by providing comment 
templates stored in scripts that can be invoked and 
inserted directly into the source code with a single 
keystroke. The script language gives developers flex¬ 


ibility in designing comment templates that suit their 
own styles and needs. 

Comment++ vl.O for Windows costs $29.95. For 
more information, contact Reliance Corporation, 
18905 Hummingbird Drive, Penn Valley, CA 95946, 
(800) 432-2118 or (916) 432-3285. 


MicroHelp Ships New, Updated Tools for VB 


VBTools 5 is the latest version of MicroHelp's col¬ 
lection of 60 VBX controls for interface building, mul¬ 
timedia, time management, etc. This version features 
enhancements to existing controls, including user 
draw capabilities in the list and tree controls. A new 
Image control lets developers display image formats 
such as TIFF, TARGA, and PCX, and includes a zoom 
facility. 

Code Complete is a new suite of tools from 
MicroHelp, and features a Splash Wizard, Code 
Analyst, and Autocoder. Splash Wizard lets develop¬ 
ers add "splash" screens to applications, and also han¬ 
dles checking various startup parameters, such as ver¬ 
sions, licensing information, system resources, and so 
on. Code Analyst provides source code reports, includ¬ 
ing cross-referencing; a code compression wizard lets 
you remove unused code. Autocoder helps you create 
code templates that can be inserted using the Project 


Wizard. Code Complete also includes tools to help cre¬ 
ate message boxes and common dialogs, along with an 
assistant to automatically generate WinHelp context 
IDs from your project. 

OLETools is a new collection of over 100 16- and 
32-bit OLE controls. Categories include interface con¬ 
trols (tab control, tree control, multi-column list con¬ 
trol, etc.), date and time controls (3-D calendar, 
masked input date and time controls), multimedia 
controls (image display and zooming, WAV file play¬ 
back, AVI playback), and special controls (.ini file 
access, a network control, a subclassing control, etc.). 

VBTools 5 costs $129. Code Complete costs $249. 
OLETools costs $189. For more information, contact 
MicroHelp, Inc., Component Products Division, 2878 
Johnson Ferry Road, Suite 200, Marietta, GA 30062; 
(800) 777-3322 of (770) 645-2121; 76325.3207@com- 
puserve.com. 
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Walnut Creek Ships NT, BSD, and Graphics CD-ROMs 


Walnut Creek has three new or updated CD- 
ROMs of interest to PC programmers. NewT for 
Windows NT is a new CD-ROM for NT users, and it 
includes programming utilities such GNU source 
code control, the GNU GCC compiler for NT, tar, Perl, 
Forth, and so on. FreeBSD is a complete version of the 
UNIX-like operating system for the PC, and includes 
full networking, UUCP, Usenet news and email, and 
other facilities. Raytrace! The Official POV-RAY CD- 


ROM is a CD-ROM for people interested in viewing 
and rendering 3-D computer images, and includes 
images, text, FAQs, software, and source code. 

Each of the three CD-ROMs costs $39.95. For more 
information, contact Walnut Creek CDROM, 4041 
Pike Lane, Ste D-100, Concord, CA 94520, (800) 786- 
9907 or (510) 674-0783; fax (510) 674-0821; 
info@cdrom.com. 


SYWARE Updates Data Replication Toolkit 


DataSync 3 is the latest version of SYWARE's data¬ 
base synchronization and replication development 
toolkit, providing an API that works with C++, Visual 
Basic, PowerBuilder, and other environments. 
DataSync gives developers ODBC-compliant tools to 
extract, replicate, and synchronize data between cen¬ 
tralized and remote databases. A graphical environ¬ 
ment lets you define user-specific data subsets from 
server databases for remote distribution, and also 
select synchronization rules to control reintegration 
of new or changed data from remote users. 


Synchronization rules can be selected from prede¬ 
fined options, or customized. This version features 
data transaction control, faster data extraction, and 
new GUI development features. 

The DataSync Development Kit for Windows costs 
$1,495. DataSync runtime licenses cost $150 per set. 
For more information, contact SYWARE, P.O. Box 91 
Kendall, Cambridge, MA 02142, (617) 497-1376; fax 
(617) 497-8729; info@syware.com; 
http://www.syware.com. 


Geodesic Ships Automatic Memory Manager for C/C++ 


Great Circle is a new memory management prod¬ 
uct for C/C++ programs. Great Circle offers a 
garbage-collecting algorithm that automatically frees 
objects when they are no longer accessible. You can 
mix manual and automatic memory management, 
and garbage collection operates incrementally (you 
can control the maximum amount of time spent on 


each collection interval). 

Great Circle costs from $300 to $500 for PC ver¬ 
sions. For more information, contact Geodesic 
Systems, 4745 N. Ravenswood Avenue, Suite 111, 
Chicago, IL 60640, (312) 728-7196; fax (312) 728-6096; 
info@geodesic.com. 


MemCheck Update Checks More API Functions 


StratosWare has released MemCheck v3.5 for 
Windows, the new version of their automatic runtime 
bug detection tool for C/C++ Windows programmers. 
MemCheck detects memory overwrites and leaks, as 
well as leaks and misuses of GDI objects (device con¬ 
texts, pens, bitmaps, brushes, fonts, metafiles, and 
regions), Windows resources (cursors, icons, menus, 
and user-defined resources), and window handles. 
Objects that are not released properly are identified by 
file and line number. MemCheck can detect invalid 
operations, such as attempts to delete stock or current¬ 
ly selected objects, and will issue a stack trace of func¬ 


tions leading up to GPFs. This version features 
expanded Windows API parameter validation and 
error detection in third-party libraries. The product 
now supports MFC and OWL development and runs 
5-20 times faster than previous versions. 

MemCheck v3.5 for Windows costs $179; 
upgrades are $59. For more information, contact 
StratosWare, 1756 Plymouth Road, Suite 1500, Ann 
Arbor, MI 48105-1890, (800) WE-DEBUG or (313) 996- 
2944; fax (313) 996-2955; BBS (313) 996-2993; 
info@stratosware.com. 
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New 32-Bit OCX Provides Industrial Control 


MicroMagic has released a new OCX for Visual 
Basic v4.0 that provides an interface to Allen Bradley 
SLC 500 PLCs. Requiring no runtime fees or software 
keys, this OCX makes it easy to integrate PLCs or 
process controllers into VB, Visual C++, or Delphi 
applications. The control lets programmers read or 
write to any memory type in the PLC, and supports 
all the AB SLC 500 data types, such as floating point 


and ASCII strings. Properties allow for support of 
networked PLCs or process controllers, and any of 
the object properties can be changed dynamically. 

The MicroMagic Industrial Custom Control costs 
$895. For more information, contact MicroMagic, 
1961 Main Street, Suite #135, Watsonville, CA 95076, 
(408) 439-8900; fax (408) 439-9217. 
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ShowBasic Demo-Ware Adds NT, Win95 

MIKSoft has released ShowBasic vl.2, the latest 
version of their Windows development kit for creat¬ 
ing interactive demos, tutorials, computer-based 
training, and multimedia titles. This version features 
support for Windows 95 and NT. ShowBasic titles can 
be developed and executed on any Windows plat¬ 
form, and can be integrated with both 16- and 32-bit 
applications. Developers can use the product to create 
programs that control other Windows applications 
via simulated keyboard and mouse input. The prod¬ 
uct includes a Basic scripting language that can call 
DLLs as well as the Windows API. ShowBasic can be 


Support 

set up as a helper application for Web browsers, and 
ShowBasic titles can be played directly from HTML 
documents. 

ShowBasic vl.2 for Windows costs $299; a royalty- 
free license is $895. A demonstration is available on 
CompuServe (sbdemo.zip in WINSDK Library 4) and 
on the Internet (ftp.cica.indiana.edu 
/pub/pc/win3/demo/sbdemo.zip). For more informa¬ 
tion, contact MIKSoft, Inc., 37 Landsdowne Road, 
East Bmnsivick, NJ 08816, (908) 390-8986; 

CompuServe: 71127,3671; Internet: niik@cnj.digex.com. 


Visual CodeBank Offers VB Functions/Subroutines 


Visual Components, Inc. has released two soft¬ 
ware development tools for Visual Basic program¬ 
mers. Visual SourceWorks 4.0 is the latest version of a 
source code control package created by ViewPoint 
Technologies. This version supports Visual Basic 4.0, 
both 16- and 32-bit versions. New features include 
support for private puts, expanded system adminis¬ 
trator and user identity controls, new checks for exist¬ 
ing projects, and support for complex structures of 
folders and subfolders. 

Visual CodeBank vl.O is a new code library man¬ 


ager that includes more than 200 royalty-free Basic 
functions and subroutines. Tasks covered include 
database operations, graphics, multimedia, sorting, 
optimization, security, and text management. You can 
add your own custom functions and subroutines to 
the central repository. 

Visual SourceWorks costs $249. Visual CodeBank 
costs $149. For more information, contact Visual 
Components, Inc., 15721 College Boulevard, Lenexa, 
KS 66219, (913) 599-6500; fax (913) 599-6597. 


LEADTOOLS Imaging Software Available as OCX 


LEADTOOLS OCX is a new OLE custom control 
that provides a variety of imaging services for both 
16-bit and 32-bit applications. The OCX offers meth¬ 
ods and properties to read, write, compress, convert, 
and display images. The control lets you perform a 
wide range of image operations, including scroll, 
zoom, dither, resize, rotate, flip, invert, reverse, trans¬ 
pose, crop, sharpen, blur, combine, halftone, deskew, 
despeckle, and gamma correct images. LEADTOOLS 
OCX imports and exports more than 40 file formats. 

Layout 4.0 Offers Improved OLE Support 

Objects, Inc. has released Layout 4.0 for Windows, 
the latest version of their object-oriented develop¬ 
ment tool for PCs. Layout allows users to generate 
standalone .exes without having to write source 
code; instead, you link objects together on the screen 
to form a flowchart. Layout for Windows is compati¬ 
ble with Layout for DOS, allowing DOS users of the 
product to quickly create a Windows version. You can 


including JPG, PNG, BMP, TIFF, WMF, EPS, PCX, 
TGA, RAW FAX, WINFAX, CALS, IOCA, PICT, PCD, 
PSD, GEM, RAS, and WPG. The toolkit also supports 
printing, TWAIN-compliant scanning devices, video 
capture, and the clipboard. 

For more information, contact LEAD Technologies, 
Inc., 900 Baxter Street, Charlotte, NC 28204, (800) 
637-4699 or (704) 332-5532; fax (704) 372-8161; BBS 
(704) 334-9045; CompuServe "GO LEADTECH". 


access third-party DLLs from Layout, or use Layout 
to create DLLs accessible to other products. 

Layout v4.0 for Windows, standard edition, costs 
$99.95. For more information, contact Objects, Inc., 99 
Rosewood Drive, Danvers, MA 01923-1300, (508) 777- 
2800; fax (508) 777-0180; info@objectsinc.com; 
http://wivw.objectsinc.com; CompuServe "GO 
OBJECTS". 


NetManage Aims Chameleon Internet SDK at VB Programmers 


NetManage has announced the Chameleon 
Internet SDK, a toolkit for developers building 
TCP/IP applications. The SDK offers a set of OCXs 
that cover WinSock (TCP/IP and UDP transports), 
secured sockets layer (SSL) for user authentication, 
HTML 2.0, CGI, client/server HTTP, client/server 


FTP, NNTP client for network news, and POP3 client 
and SMTP for mail. 

For more information, contact NetManage, 10725 
North De Anza Boulevard, Cupertino, CA 95014, (408) 
973-7171; fax (408) 257-8789; marketing@netman- 
age.com, www.netmanage.com. 
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Crescent Offers Internet OCXs for VB 4.0 

Crescent Internet ToolPak is a new product 
designed to help Visual Basic programmers build inter¬ 
networked applications. The event-driven controls con¬ 
form to applicable RFC standards and shield program¬ 
mers from the details of the various Internet protocols. 
The tools include a mail control for creating email 
applications (supports POP, SMTP, and MAPI), a news- 
group control for building customized newsreader 
applications, a Web control for creating custom Web 
client applications, an FTP control for accessing FTP 
servers, a client/server control for TCP/IP messaging 
and file transfer, and an add-in wizard that asks a series 
of questions about the desired Internet application and 
then helps generate the code for that application. 


VB4 Plus Pak is a new collection of tools, OCX con¬ 
trols, and written guides designed to help VB devel¬ 
opers move to Visual Basic 4.0. Based on Crescent's 
"jump start kit," VB4 Plus Pak eases the transition to 
the new major version of the language. The package 
includes a calendar control and a control for sending 
Internet mail via SMTP. 

Crescent Internet ToolPak costs $199. VB4 Plus Pak 
costs $49.95. For more information, contact Crescent, 
a division of Progress Software Corporation, 14 Oak 
Park, Bedford, MA 01730, (617) 280-4000; fax (617) 
280-4025; crescent@progress.com; 
http:! lwzvw.progress.com/crescent. 


Add CAD Abilities with DbCAD dev DLL 


DbCAD dev DLL vl.4 is a 16-bit Windows library 
of graphics and database functions. The library lets 
you: manage a graphic window that offers pan, 
zoom, overview, and copy buttons; display raster 
images on which you can overlay vector drawings; 
print graphic images and text; import (from DXF and 
DWG files) create, select and edit all the AutoCAD 2D 
vector entities, including properties (color, layer, line- 
type). This version features overlaying of more raster 
files, the ability to load a portion of a raster file, load¬ 
ing a raster file to a different resolution than the orig¬ 


inal, loading TIFF files, simplified loading of DWG 
files with automatic calibration, managing of polygon 
entities type, importing of extended entities data EED 
from DWG and DXF with compatibilities with ASE 
and ADE, print scaling, print preview, and more. 

DbCAD dev DLL costs $450, a single runtime 
license costs $99, and an unlimited runtime license 
costs $990. For more information, contact Channel 
Inc., 6 Graham Road, Lexington, MA 02173-1712, 
(617) 861-7824; fax (617) 862-0704; FAX-ON-LINE 
(617) 863-0068; 100447.1747@compuserve.com. 


Mr. Phelps Provides Copy Protection, Selective Disabling 


Mr. Phelps is a new software security product 
from Lever Software Systems, providing C/C++ pro¬ 
grammers with copy protection, selective disabling, 
and installation. The product ships with full source 
code (works with Windows 3.x and DOS) and lets 
you prevent usage of your software past a specified 
date, number of days, or number of executions. When 
the usage is exceeded, the executable will be deleted. 
Alternatively, you can create an executable that 


begins requesting a password when the usage is 
exceeded, allowing you to enable the product remote¬ 
ly for customers who contact you and purchase the 
product. Mr. Phelps also provides features to help 
you enforce a one-copy, one-installation license 
requirement. 

Mr. Phelps costs $99. For more information, con¬ 
tact Lever Software Systems, 19 Clinton Place, lltica, 
New York, NY 13501, (800) 638-7250. 


NetManage Aims Chameleon Internet SDK at VB Programmers 


Az-Tech is now shipping Safe-D, a package that 
helps protect software distributed via CD-ROM. Safe- 
D lets you create trial or demo versions of applications 
that will be distributed online or via CD-ROM. Once 
the customers decide to purchase the program, they 
can call you to receive an activation code that turns the 
demo version into a fully functional package. Features 
include verified registration, hard disk lock, CPU lock, 
network lock, date and execution count limits, access 


flags, secure user data, encryption, and serialization. 
The product includes DLL functions to support a cus¬ 
tom activation process. Safe-D works with DOS, 
Windows, Windows 95, and Windows NT. 

The Safe-D Professional System costs $495. For 
more information, contact Az-Tech Software, Inc., 201 
East Franklin, Suite 11, Richmond, MO 64085, (800) 
227-0644 or (816) 776-2700; fax (816) 776-8398; 
aztech@tyrell.net. 


WebSite 1.1 Offers Improved HTML Support 


O'Reilly & Associates has released WebSite vl.l, 
the latest version of their 32-bit multithreaded Web 
server for Windows NT and Win95. New features 
include the HotDog HTML editor, multiple search 
indexes, HTML v3.0 support, server side includes 
(SSI), Windows 95-type installation, and a VB 4.0 


framework for CGI. The package also includes a 400- 
page book. Building Your Own WebSite. 

WebSite vl.l costs $499. For more information, 
contact O'Reilly & Associates, Inc., 103 Morris 
Street, Suite A, Sebastopol, CA 95472, (800) 998-9938 
or (707) 829-0515; fax (707) 829-0104. 
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Readers' Forum 


Send letters to wdletter@rdpub.com. 


Correction: 

Due to editing errors, the opening para¬ 
graph of Trevor Harmon's Tech Tip entitled 
“A C++ Class for Microsecond Timer 
Services" in the February issue was incor¬ 
rect. The correct version is as follows: 

Programmers of the Win32 API have 
two options for timer services. The typi¬ 
cal solution is to call SetT i mer (), which 
sends the WM_TIMER message at specific 
intervals. But SetTimerO has a resolu¬ 
tion of only 50 milliseconds to 100 mil¬ 
liseconds, depending on the speed of the 
computer. The other option is to create a 
multimedia timer. By calling 
timeBeginPeriodf ), Win32 will generate 
a timer service with a resolution as low 
as 20 milliseconds. 

Our apologies to readers for the confu¬ 
sion the error may have caused. 


Hello Ron, 

Do you have an updated copy of 


ClipBase? The one published in the July 
1995 issue ("A Code Fragment Database 
for Windows 95") causes GP faults after 
being compiled with BC++ 4.52. In fact, 
it won't even clean-compile. 

BTW, this is the most original use of 
Tree View I've seen. 

Regards, 

Tarkan Yetiser 
VDS Advanced Research Group 
tyetiser@yrkpa.kias.com 

When I wrote that article, Borland 4.52 
had not yet shipped. When it did, a couple of 
readers complained, but I still didn't have 
4.52, so I suggested some things that didn't 
seem to help. Finally, my Borland C++ 
v4.52 arrived and I knuckled down and 
worked on this until I solved the mystery. I 
was pretty baffled initially, and I eventually 
disassembled and dumped to see what the 
difference was between the working cl ip- 
base. exe (produced by Visual C++ v2.2) 
and the broken cl ipbase.exe (produced by 
Borland C++ v4.52). After more hours than 
I care to admit to, I discovered that 
Borland's resource compiler, when compil¬ 
ing the dialog containing the treeview con¬ 
trol, was producing a dialog resource that 
referred to a window class of “SysTreeView" 
— but the correct window class is 
“SysTreeView32"! The former class is pre¬ 


sumably the 16-bit version of the treeview 
control, and not a real good thing for a 32- 
bit app to try to create and send messages to. 

The problem is that Borland's commc- 
trl. h assumes that if you are doing 32-bit 
code, then the macro _W IN32 will be defined. 
However, _WIN32 only gets defined in win¬ 
dows .h if the predefined macro _ BOR- 

LANDC _ is defined. Nozv, _ BORLANDC _ is 

predefined by Borland's compilers, but not 
by its resource compilers. Thus, when run¬ 
ning the resource compiler (brc32.exe), 
_W IN32 never gets defined, the window class 
WC_TREEVIEW in commctrl .h expands to the 
wrong value ("SysTreeView"), and things 
go very wrong at runtime. The workaround 
1 used is to put a #define _WIN32 at the 
beginning of my . rc file, before any other 
lines. That workaround makes ClipBase 
compile correctly, but I know of no 
workaround (short of rewriting Borland's 
header files) that will make the Borland 
resource compiler accept all the possible 
common controls and their style bits. This is 
a really nasty Borland bug. 

While trying to track this bug down, I 
used the new Win95 BoundsChecker and 
discovered that it seemed to erroneously 
claim that my Borland-compiled code was 
overwriting memory in the following very 
simple code: 
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Windows NT Drivers 


Development 

Consulting 

Training 

by the best in the industry 

• File Systems • Kernel Mode Drivers 

• NDIS Drivers • Systems Internals 



105 Route 101 A, Suite 19 

Amherst, NH 03031 

(603) 595-6500 — info@osr.com 


Call or email for a free no obligation quarterly subscription to 
The NT Insider , the world’s only newsletter dedicated entirely 
to Windows NT systems software development! 
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Call 1-800-775-1073 

Never shell out to 
the O/S again! 
Crusher is a robust 
set of functions 
that provide your 
DOS, Windows, 
OS/2, Unix, and 
Mac applications 
high performance, portable 
data compression. 

$249 - 

$299 Buffer & file compression, 
$299 disk sp anning, encryption, 
$349 self-extr. EXE's, VBX and 
$349 OCX controls, on- 



DOS 
Winl 6 
Win32 
OS/2 
Unix 


Macintosh $299 

FREE DEMO 


help, full source code, 
and more. 


Tel 606-268-1559 
Fax 606-266-0726 
http://www.dcmicro.com bbs 606-268-1251 


24-hour information by fax 
1-800-234-0141, doc #1151 
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Basic Scripting 


Cypress Enable 2.5 


Basic Scripting for Applications 

A powerful, complete, royalty free, VBA 
compatible, embeddable Basic Scripting 
Language. Cypress Enable Features: Royalty - 
free licensing, 30 day money back guarantee, 
OLE 2.0 Automation, Direct access to C++ 
objects, Dynamic Dialogs, Dialog Editor, 
Debugger (w/source), Recorder, Named 
parameters, Easily extended, Printed and on¬ 
line documentation, Redistributable end-user 
documentation, Small footprint engine < 200K, 
Free technical support. 16 bit $ 495 , 16 & 32 bit 
in one box $995. For a free whitepaper call: 



email cypress@cypressinc.com 
Fax:(602) 951-8047,CIS 70444,165 

□ Request Reader Service #151 a 


www.dice.com 


DICE is looking for Data Processing, Engineering and 
Technical Writing professionals to fill open positions 
for companies nationwide. 

DICE is a FREE online job search service, providing 
detailed information about current contract and fulltime 
positions across the USA. Please contact by calling ANY of 
these access numbers, using your computer & 1200-9600 
baud Modem, 8-N-l. 


California. 

Georgia 

Illinois 

Iowa 

Massachusetts 
New Jersey 
Texas 
Internet 
Web 


408 - 737-9339 
404 - 523-1341 
708 - 782-0960 
515 - 280-3423 
617 - 266-1080 
201 - 242-4166 
214 - 691-3420 
telnet dice.com 
www.dice.com 


DATA PROCESSING 
I NDEPENDENT 

Consultant's i 
Exchange . 


A Service of D&L Online, Inc:. (515) 280-1144 
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Bar Codes Can Be Fun. 


Honest! 

If you can change fonts, you can 
create bar codes. Code 128, Code 
other symbologies. 

800 48-ASOFT 
206 932.6028 
info@azalea.com 
www.azalea.com 
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azalea 

software inc. 


Phone Sound: Simple! 

For Windows/DOS Voice Mail & Fax Developers 



1. Create fantastic prompts 
and save time with VFEdit®'. 
Record, crop, cut, copy, paste, 
mix, fade, echo, volume & 
more with your Dialogic™ 
D4x/12x boards. 

2 . Add Voice Mail power to 
your MS Windows apps with 
TI/F DLL™, our Tel I/F 
Dynamic Link Library. 

3. Scribe plays digital audio 
files without voice hardware! 


Professional 
Tools for 
your Voice 
Mail, Fax & 
Audiotex 
Applications 


4 . Add Text-to-Speech 
capability with VoxFonts™, 
our text-to-speech library! 

5 . Audio Tool Box™ 
converts between Multimedia 
Wave (16, 8 & MS ADPCM), 
unsigned 8, linear 16, CCITT 
G.711/G.722, Dialogic 4/8 & 
more! Batch convert, crop, 
chop, normalize & filter. Add 
conversion to your apps with 
our ToolBox SDK'. 


VS/ Order Now! 800-234-VISI 


VISI, 2118 Wilshire Blvd, #973, Santa Monica, Ca 90403; 310-392-8780 
Fax 800-234-FXIT / BBS: 310-392-6610 (Download our Working Demos) 
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SCAN TOOLS 



* Barcode recognition + insert 
■ Noise removal 

• Skew correction 

* Line removal 

• Tiff rhw - de /compress - scale 

Axtel, Inc. 

18255 Ml. Baldy Circle 
Fountain Valley, CA 92708 
Tel: (714)964-6666 
Fax:(714)964-6766 
_CompuServe: 75270,2412 


Free demo on http://www.axlel.com 
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Dr. DeeBee" 
ODBC Tools 

Tools for ODBCjdevelopment 

Ever wonder why 
your ODBC app is not 
working? Why it’s just 
too slow? If the ODBC 
driver is OK? 

Dr, DeeBee utilities reveal the inner workings of ODBC. 


Call for a Free ODBC prescription! 


Connect proprietary databases to 
Access. Visual Basic, and PowerBuilder 
with our Dr. DeeBee ODBC Driver Kit 

-5W//E-- 

RO. Box 91 Kendall, Cambridge, MA 02142 

617 - 497-1376 Fax 617-497-8729 
http://www.syware.com/drdeebee/ 
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The Fastest xBASE Engine... 

for C, C++, Visual Basic and Delphi 
database application programmers! 

With CodeBase 6.0, you get: 

• Multi-user compatibility with 
FoxPro, Clipper and dBASE files. 

• Portability between Windows, 

Win95, NT, DOS and UNIX. 

• Support for the popular C/C++ 
compilers, Visual Basic and Delphi. 

• Data aware controls for Windows. 

• Powerful visual report writer. 

• Client/Server option. 

• Royalty Free distribution. 

FREE 30 day trial 

Call Sequiter Software Inc. for details! 
Phone: 403 437 2410 FAX: 403 436 2999 
Internet: sequiter@supernet.ab.ca 
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PROGRAMMERS... 

$100k/yr at HOME! 


My new book, "How To Make $100,000 A 
Year And More Developing Low Budget 
Software Products", will reveal all the 
marketing tricks, strategies, and systems that 
have my business exploding with PROFITS! 

Add your skills to my proven strategies and 
you have the PERFECT BUSINESS ... Low 
overhead, part-time, home-based, huge 
margins, and UNLIMITED POTENTIAL . 


CALL 800-364-4883 


Call TODAY for a FREE special report! 
ULTRA _ Fax: 214-724-0375 

Financial Systems CompuServe: 71223,634 

1633 Arrowhead Dr, Flower Mound, TX 75028 
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S/W ENGINEERING POSITIONS NATIONWIDE 



We Understand 
Programmer’s 
Mind* 


When the country's 
top firms look for 
the best develop¬ 
ers available, they 
turn to Bateman. 
Why? Because we 
specialize in MS 
Windows, NT, OS/ 
2 and Macintosh re¬ 
cruiting nationwide. 
So if it’s time for a 
career move, give 
us a call. We un¬ 
derstand your 
skills, and the mar¬ 
ketplace for them... 
we understand you. 


It Bateman Inc. 


5B47A Uplander Way 
Culver City, CA 90230 
Tel: 310-641-4100 Fax: 310-641-2900 
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WI N32_FIND_DATA Data; 

FindFirstFile(“C:\\*.*”, &Data); 

Dan Babcock at Nu-Mega was kind enough 
to investigate this, even though Nu-Mega 
had not yet received Borland C++ v4.52. It 
turns out that Borland C++ v4.52 reports a 
different (smaller) sizeofO for 
WI N32_F I ND_DATA than Visual C++ v2.x 
does, and that (indirectly) caused 
BoundsChecker to incorrectly claim too 
much data was being copied. 

This is the first time 1 have hit a bug 
resulting from a problem I have long won¬ 
dered about: Microsoft's vague API docu¬ 
mentation does not specify how operating 
system structures are packed. In practice, 
most such structures have their fields 
arranged so that they are compatible with 
most any alignment you might reasonably 


pick (1-byte alignment, 2-byte alignment, or 
4-byte alignment). In this particular case, if 
the data is 4-byte aligned, then the structure 
has some unused bytes at the end. I don't 
really blame this bug on Borland, but it is 
just a fact of life that the only real specifica¬ 
tion of the Windows API(s) is the one you 
obtain by reverse engineering, so Borland 
will have to change its default compiler 
behavior to comply with the Microsoft tool. 

Nu-Mega does not plan to change 
BoundsChecker behavior in this area, 
because the only safe assumption is that 
Windows uses the larger structure size that 
comes from assuming 8-byte packing. 
BoundsChecker also printed some incorrect 
symbol names when reporting errors in 
Borland C++ v4.52 executables. Dan says it 
looks like Borland changed something about 
its symbol format, and Nu-Mega is working 


on a fix to account for it. 

Another problem with Borland C++ 
v4.52 is that, like Watcom C++ vl0.5, it 
shipped with an incomplete SDK that 
Microsoft apparently licensed out to some 
compiler vendors before shipping a more 
complete version (but still with really poor 
documentation) to Microsoft customers. 
That means, for example, that the online 
help files are missing documentation for 
important things like the common controls, 
and one or two of the more obscure header 
files (e.g., dbt.h) are missing. I'm not sure 
Borland and Watcom could have avoided 
getting the short end of the stick (and pass¬ 
ing that on to customers), but I highly rec¬ 
ommend upgrading to the new versions of 
these compilers as soon as they are available. 
—rib 
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* Dazzle/VB - image manipulation. $199 

* VBIite - print/comm/array/B-Tree index.. $149 

* ProMath/VB - numerics/statistics. $149 

* FinLib/VB - financial calculations. $149 

* QuickLine/VB - telephony (multi-line) ...$495 

* SpellCheck/VB - spelling & lookup. $49 

* QB/C/dBase - 15 more DOS libraries ...$call 

* Custom - C, VB, ASM programming . ..$80/h 


Develop your VB app faster: Get TeraTech 
tools! Call. E-mail or fax us and we’ll mail you a 
free demo disk ASAP. Or for faster service 
download by FTP or from our BBS. Call now!. 

800-447-9120 ext. 1199 

Dept. 1198, 100 Park Avenue, Suite 360, Rockville, MD 20850 USA 
Int’l: +1-301-424-3903 Fax:(301)762-8185 BBS: (301) 762-8184 


Copyright TeraTech 1995. A1 rights reserved. Trademarks are the property of their holders. 
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Free CDROM! 


Sampler CDROM: You get useful sam ples froml 
44 CDROMs +- $5.00 check inside— IJ ;l J*5 l 

*Free with regular S5.00 shipping charge _ 

Cica MS Windows: 2-disc set! 4000 new $29.95* 
prgrms, games, utilities, drivers, code, fonts. 

Simtel MSD0S: Now 2-disc set! 1000 MB $34.95* 
MSOOS shareware (utils, games, code, etc.) 

Hobbes OS/2: OS/2 Mag's Product of the Year! $29.95* 
600 MB of OS/2 Shore/Freeware (2-disc set). 

C Users' Group Library: C Users'Journal $49.95* 
Archive: 10 yrs of C code & articles 
Source Code : 650 MB C, Usenet Unix, DOS $39.95 
Toolkit for Linux: Slackwore 2.0 32-bit 0/S $39.95 
for PC with GNU & XI1. Src. (2-disc set!) 

FreeBSD 2.0: Berkeley BSD, 32-bit 0/S for $39.95 
PC, with GNU & X11. Full source. 

Internet Info: 12,000 computer, network. $39.95 
Internet documents. FAQ's, RFC's & lEN's 
Space & Astronomy: Thousands of NASA $39.95 
images -I- viewer, 5000 data files, prgrms. 

♦shareware requires separate payment to authors if found useful 

Call Now for our Free Catalog! 1 -800-7 86-9907 

Walnut Creek CDROMIE191 
1-510-674-0783 - FAX 1-510-674-0821 
email: orders@cdrom.com 
4CVt 1 Pike Lane, Suite D-692 Concord, CA 94520 | 692 
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Port I/O on NT/95 


WinStar Hardware Classes 2 

i 

Hardware access library for Win32 
and VB4 applications. 

« C routines, C++ classes, and OCX 

♦ Port and physical memory access 

♦ Interrupt service routines 

♦ Supports both Windows 95 and NT 
o No DDK development required 

Other WinStar products... 


«Device Talk NT driver debugger 
«Kernel BASIC cross-platform driver 
development environment 



WinStar Technologies. 

(415) 647-2815 

74367.1773@compuserve.com 


visit us at http://www.wintech com 
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Structured Hierarchical Diagramming 


B-liner 

(bracket outliner) 


Introducing B-liner, a powerful new hierarchical 
diagram editor. B-liner diagrams are a perfect tool for 
designing, analyzing & communicating your programs, 
databases, and business processes. 

Diagrams can range from informal to-do lists to formal 
program specifications. Use B-liner when you need to 
communicate clearly & precisely. Ideal for Warnier/Orr. 
Creating B-liner diagrams is easy. As you add and 
remove information to a diagram, B-liner automatically 
sizes the diagram to fit. Other features include: 


powerful text editing 
and formatting 
diagram scaling 
drag & drop editing 
pagination 


collapse/expand sub¬ 
diagrams 
command toolbars 
footnotes 
on-line help 


B-liner can be used alone or within OLE 2.0 applications 
like Word & PowerPoint. B-liner is a 32-bit application 
for Windows 95/NT and Windows 3.1. 


Limited Time: $149 
60 Day Money Back Guarantee 


VISA/MC/PO/Check 

| (508) 685-7003 

I For free demo & Info: http7Avortd.std.conV~varatek 

Varatek Software, Inc. #264,733 Turnpike, No.Andover, MA 01845 
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Add ZIP (and UNZIP too!) to 
your Windows applications! 


, DynaZIP 3 0 

f Data Compression Toolkits 


The new ROYALTY-FREE DynaZIP family of 
developer's tools let you add ZIP and 
UNZIP capabilities to your Windows 
opplicotions. No more "shelling" to 
DOS, no more fussing with proprietory 
compression formots. DLLs, VBXs, OCXs 
and o new dotabase interface provide 
full occess from many languages. Fast, 
reliable, and easy to use! 16 and 32 
bit versions, supports long filenames. 


Fully Supported, 
w/30-day no-risk guarantee! 
Call today, toll free: (800) 962-2949 


Inner Media. Inc., Hollis NH USA (603) 465-3216, fax (603) 465-7195 
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Developer Jobs! 

Internet: ngi@scientific.com 

Commercial software developers should con¬ 
sider registering with Scientific Placement. 
R&D jobs for software engineers, SQA, prod¬ 
uct managers, etc. Nationwide contacts with 
both large and small companies including 
start-ups. Many clients develop commercial 
software products. Most develop for Win¬ 
dows, NTi Macintosh, OS/2, and Unix based 
platforms. We also recruit in other leading 


graduate engineers, 
marketability assessment. Never a fee. 

Scientific Placement, Inc. 
800-231-5920 Fax 800-757-9003 
http://www.scientific.com 

CompuServe: 71250,3001 AGL:davesmail 
SPI8, Box 19949, Houston. TX 77224 
713-496-6100 Fax:713-496-0373 
SPI8, Box 71, San Ramon. CA 94583 
510-733-6168 Beth@spicaMt.com 
SPI8, Kenmore Station, Box 15225 
Boston, MA 02215 617-424-8372 jen@spbos.pn.com 
SPI8, P. O. Box 202676. Austin, TX 78720-2676 
l 512-260-0123 lej@zilker.net _ 


III 

© 


Spy on any Windows Program! 


API Vision 



Total detail display for 2000+ APIs in 36 
categories, including base APIs, drivers, 
multimedia, networking, OLE, winsock, 
undoes and more. 


“Insanely Great” 

Software Development Magazine 


$199 


+ $8 ship. 

MasterCard, Visa 

30 day money-back guarantee 


Berkeley Toolworks “^r 4 ’ 5 

800-593-5103 510-649-9891 apivis@berktool.com 
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DRS OCR TOOLKIT 


With its flexible C language API, I R I S, 
has been recognised as being one of the 
most popular and easy to integrate OCR 
packages for Office Automation, DTP, 
Banking, Fax and Database applications. 
I.R.I.S. now offers a complete range of 
OCR engines for full page reading through 
to fast, high performance single line and 
index field reading applications. 

I.R.I.S. technology incorporates Omnifont 
techniques, Linguistic analysis and 
powerful Learning capabilities and supports 
recognition in 29 different languages 
(including Eastern European, Greek and 
Cyrillic). Available for many platforms 
including : PC, UNIX Workstation, MAC & 
PowerPC. 

Call us! 


I.R.I.S. (U.S.A.) 

Tel: (408) 255 7190 
Tel (407) 395 7831 


Fax :(408) 255 7140 
Fax :(407) 995 9290 


I.R.I.S. (Europe) 

Tel : (32) 10 45 1364 Fax : (32) 10 45 3443 


imRBE 
RECOBniTIOn/ 
I nTEGniYTED ' 
5y5TEm5 
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Transform WinHelp from a 
passive display viewer to an 

I INTERACTIVE APPLICATION DRIVER! 


IH - the new WinHelp DLL extension language is 

the perfect tool for WinHelp interactive applications. 

Use IH to: 

• Design and process forms & dialogs using option lists, 
edit boxes, input validation, etc. 

• Create dynamic help topics using dynamic text fields 

• Embed video clips in WinHelp topics and activate them 
from your procedures 

• Connect to external databases using a dynamic 
dispatch function mechanism 

• Trap and handle WinHelp events using a structured language 

• Expose and use the WinHelp internal extension functions 

• Activate macros automatically upon topic entry and exit. 


Get Interactive Help for Windows 
for $149 ! 



P.O.Box 5517. Coralville, IA 52241. USA. 
TeleFax. (319) 351-8413. CompuServe 76350,333 
Internet: rhalevi@hyperact.com 
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•WinEdit 96 • 


$99.95 WinEdit 95 for Windows 95 and 
Windows NT has a 372-function 
Windows macro language, 5 MB file 
handling, compile automation for most 
languages, and automatic text coloring. 

It's for C++ and other languages. Demos 
are free for the download! Or buy under 
our 90 day, money back guarantee. 

• For your free, eval copy: 

BBS: 206-935-5198 
AOL: WirtdowWare 
CompuServe: WINAPA, Sec. 15 
FTP: www.windowware.com /wwwftp/wilson 
WEB: http://www.windowware.com/wilson/pages/ 
Orders: 1-800-938-4599 
Wilson WindowWare, Inc. 
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Demo / Tutorial / CBT / Presentation 
Visual Windows Automation 
Multimedia Authoring Development Kit 

C3 Use ShowBasie Recorder to generate the editable, 
mouse/keyboard simulation code invariant to window's 
size and position, screen resolution and video driver. 

□ Achieve visual control over external applications 
and unlimited flexibility by programming in full 
featured Basic extended with the unique presentation 
and CBT related functionality, use even access to 
external DLLs and Windows™ 16-bit or 32-bit API. 

Q Pack your application in a compressed executable 
with the small self-installed run-time and all supporting 
files (BMP. WMF. WAV, MIDI, AVI), compatible with 
Windows 3.1, Windows 95 and Windows NT . 

□ Deliver your titles transparently via WWW - 
ShowBasie can be integrated with any WEB browser. 

Development license 5299 with 30 day money back guarantee. Royally free license $895. 

If you don't need all the power of ShowBasie - use our simple, 

yet flexible scripting: language for live demos and automation: 

STT1DHEMLO 

Single-user license $30 (SMI Pro). Royally free license $300 ($500 Pro). Visa/MC accepted. 

Find more information, demos, samples and evaluation copy: 

http://www.cnj.digex.net/~mik 

n M IK Soft, Inc. tel/fax: 908-390-8986 

37 Landsdowne Road. East Brunswick NJ. 08816 
Internet: mik@cnj.digex.net CompuServe: 74127.3671 
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Easily 
Move to 
Windows 95 
Help 


The Moving to WinHelp ‘95™ Kit automatically 
converts your existing Windows 3.x Help systems 
to Windows 95 Help systems. 


Automatically adds Windows 95 features to your 
Help systems and updates your source files. 
Works with all Help systems whether they were 
produced manually or with a development tool, 
includes Mastering Windows 95 Help-the Official 
Book for Help Authoring. 


Call 1-800-718-4406 

now for the fastest and easiest way to 
move existing Help systems to Windows 95. 

BLUE SKY SOFTWARE 

Inti: 1-6194596365 Fax: 16194596366 


-i Request Reader Service #171 3 


Lexicus Longhand ™ 

Handwriting Recognition Software 
Windows Developer Version 



• recognizes cursive, print and mixed styles 
• dictionary building tool included 
1-800-LEXICUS or 415-462-6800 
internet: info@lexicus.mot.com 
uri: http://www.mot.com/lexicus/ 
Lexicus, A Division of Motorola 

® MOTOROLA 
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Opt-Tech Sort/Merge 


^ New - Version 5 

High performance Sort/Merge/Select 
utility. Run as a stand alone 
utility or CALL as a subroutine. 

Supports most languages and 
filetypes including Btrieve 
and dBase. Unlimited filesizes 
multiple keys and much more. 

MS-DOS, Windows $149 
OS/2, UNIX $249 

Call to order or for free info. 


Opt-Tech Data Processing 

P.O. Box 678 
Zephyr Cove, NV 89448 

(702) 588-3737 j 
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To: Ton Plooy 
From: Tony Parsons 

I found your article, "A DLL Load 
Monitor," in November 1995 WDJ most 
useful and educational. I did, however, 
find a small bug in the code. Some files 
caused an Exception 13 when dis¬ 
pell 1 .exe was run. I traced the problem 
to Fi 1 eNameProcl ). It turns out that some 
files with no Version data can return a 
non-zero value from 

GetFileVersionInfo( ). This then leads 
to a GPF from the call to 
VerQueryVal ue( ). The following code 
fixes the problem. 

DWORD handle;// new 


// replaces call to GetFileVersionlnfoO 
if (Get Fi 1 eVersion InfoSizefszBuf, &handl e)—0) 

{ 

STRLWR((LPSTR)lParam); 

} 

else { 

GetFi1eVersionInfotszBuf, handle, 
sizeof(_pResData), _pResData); 
if (VerQueryValueCCvoid *)_pResData, 
"VVarFilelnfoHTranslation”, 

(void **)&1pWord, SwSize) !- 0) 

{ 

wsprintf(szBuf, 

“\\StringFileInfo\U04XM4X” 

“WFi 1 eDescription”, *1 pWord, 

*(1pWord + 1)); 

} 

From Ton Plooy: 

One serious bug appeared in the DLL 
load monitor code. Apparently 
EndLoadDl 1 () can't be called at DRV_FREE 
time — if it is, it will crash the system when 
a Windows restart is done. When called at 


WM_ENDSESSION time all is fine. Here's the 
code I changed/added: 

case DRV_FREE: 
break; 


and in LoadWndProc(): 


ii... 

case WM_QUERYENDSESSION: 
return 1; 

case WM_ENDSESSI0N: 

if (wParam -- TRUE) { 
EndLoadDLLO; 
return 0; 

} 

return 1; 
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Employment Service 


SALARIED SOFTWARE 
DEVELOPMENT AND 
SUPPORT ENGINEERS 


Clients and affiliates nationally... 
Clients pay our fees (always), and 
your interview and relocation 
expenses (usually). 

RSVP SERVICES 

trusted by computer professionals 
since 1966 


Ref: WDDJ 

PO Box 8369 Cherry Hill NJ 08002-0369 
Voice: 800/222-0153 
Fax: 609/667-2606 
Internet: npa1621 @connectinc.com 


mail/fax/email resume J 
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C and C++ DOCUMENTATION 


!! VERSION 6.0!! 

• C-CALL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

• C-CMT ($69) Creates/inserts/updates comment- 
blocks for each function, listing the functions 
and identifiers used by it. 

• C-METRIC ($59) Counts path complexity, counts 
comments, code, 'C' statements. 

• C-LIST ($69) Lists and action-diagrams, or 
reformats into standard formats. 

• C-REF ($69) Creates cross-reference of local/ 
global/define/parameter identifiers. 

• C-DOC ($199) Package All 5 programs integrated 
as DOS program. <10,000 lines. 

V6.0 C-BR0WSE Windows graphic-tree viewer. 

• C-DOC Professional ($299) DOS, Windows, OS/2. 
3-ring binder/case. <1,000,000 lines. 

30-DAY Money-back guarantee. CALL NOW! 

SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauga Voice/Fax (905) 858-4466 
0NT Canada L5N-4M1 http://swbs.idirect.com 


Please see Ad Index for our larger ad. 
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The MFC Windows Control Construction Kit 
A Programmers Resource 

By Jack Tackett, Jr. and Keith E. Bugg 

Book includes a disk! 

Learn HowTo: 

□ Create owner draw controls with 
bitmaps. 

□ Display, but disable, list box items. 

□ Subclass controls, simplified at last 
Use the new Windows 95 

controls, including: 

Q Tabbed dialog boxes • Bullet items. 

□ Animation control. 

□ Rich Text editor. 

□ Image lists and Tree View controls. 

□ Toolbars, Trackbars and Statusbars. 
Combine ALL Controls For 

Special Effects! 

Order your copy today! 

$ 39.95 

plus shipping 

SPC Order Number: 

1.800.628.0903 

SPC Fax Number: 

1.205.664.6984 

ISBN 0-9644301-0-X 

Using the MFC Windows Controls 

Constructon Kit, you will ouickly master all 
the skills necessary to implement effective 
AND visually appealing dialogs. This quide 
is written by seasoned programmers who 
show you not only how to make the most 
of the existing controls, but also the new 
ones introduced for Windows 95 and 
Windows NT. This book is short on abstrac¬ 
tion and long on practical examples and 
stands as a bridge between the 16 and 32 
bit worlds. This is one book every serious 
MFC developer needs for their library. 

Tristar Systems, Inc. 
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Report woes? 

Slow, large, impossible? 


PrintForm 

Create complex, impossible reports. 

High quality documents, very well suited 
for form letters, reports and tables. Icons, 
bitmaps, texts. Fonts, word-wrapping, ali¬ 
gnment, headers, footers, numbering. DLL 
and C++ API. Demos in CompuServe: 
MSMFC or MSBASIC. 

DLL and source versions, 16- and 32-bit. 
30 day money-back guarantee. 

KWG Software: CIS: 100010,204, Tel: +49-531-72982 
Fax: +49-531-74501, pfo@kwgsoft.s-link.de 
European Software Connection: 800-986-6578, 913- 
832-2070, Fax: 913 832-8787, CIS: 71141,3624 
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| Does your company 
provide tools, products, 
or services for advanced 
Windows programmers? 
Then reach over 22,000 
serious programmers in: 

Windows 

□ DEVELOPER S JOURNAL 

The Magazine for Windows Programmers 


Call 913 - 841-1631 today for 
information about 
advertising opportunities in 
Windows Developer’s Journal. 


1 breakout! marketing - Continental Europe. 

1 +49 431-801740 


1 Ed - East 1 Christine - Midwest 

Julie - West 

■ 913-838-7547 1913-838-7546 

1913-838-7541 


Page 80 — Windows Developer’s Journal 
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Visit our Internet site at http://www.accusoft.com 


Platforms 

Supported 


The Ultimate High Performance Imaging Toolkit! 

Add Support for Over 36 File Formats Instantly ! 


Now with PNG!* 
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AccuSoft Image Format Library 5.0 


Ultimate Imaging Toolkit 

AccuSoft provides the ultimate imaging 
toolkit solution with the highest 
performance, most formats & platforms, 
most complete API and the best pricing. 
That is why we are the industry leader 
and why over 5000 companies have 
chosen AccuSoft for their imaging 
needs! 

Performance 

AccuSoft has always been known as the 
performance leader. We know that you 
want the fastest imaging possible and 
that fast is never fast enough. 

Therefore, we constantly work on 
improving performance to keep us 
(and you) ahead of the competition. 

Quality 

AccuSoft has become the leader in 
imaging toolkits due to our untiring 
commitment to quality. Not just 


Toll Free: (800) 525-3577 

Internet: http://www.accusoft.com 
CompuServe: Go AccuSoft 


product quality, which can be seen in 
our unique guarantees, but also service 
quality from our special fast delivery 
program, top rated technical support and 
rock-solid technology. 

Pro Gold 

The Pro Gold versions of our imaging 
toolkits are unbeatable for performance 
and special features like scale to gray, 
sub-degree rotation, sub-second 
decompress & display, sub-second 
screen rotation, huge image handling 
and more. 

If you want the best performance 
available anywhere at any price, this is 
it. 

Cross Platform 

With this toolkit, you can sell your 
applications on many different platforms 
without having to recode the imaging 
portion. AccuSoft's cross platform 


design is tailored for easy 
porting, and since we 
support ALL platforms, 
your products can be sold to 
every market. 

Order Today 

Call now and you can start 
writing high performance 
imaging applications in less 
than an hour. Our unique 30 
minute delivery program is 
also the fastest in the 
business! 



AccuSoft 

High Performance Imaging" 


Two Westborough Business Park Westborough, MA 01581 Tel (508) 898-2770 FAX (508) 898-9662 

All company and brand names are trademarks or registered trademarks of their respective owners. 

*Free Upgrade for 5.0 users. PNG is the replacement format for GIF. 1. Raster only 2. Read only (Does NOT require separate DLL from Kodak.) 

©1995 AccuSoft Corporation. All Rights Reserved. 


Windows 
Win 95\NT 
DOS 
DOS32 
VBX 
OCX 
OS/2 
FoxPro 
SUNOS 
Solaris 
HP-UX 
AIX 
SGI 
SCO 
MAC 

PowerMac 

Over 36 
File Formats 
Supported 

TIFF 
JPEG 
Group III 
Group IV 
PCX 
TGA 
DIB 
DCX 
GIF 
BMP 
WMF 1 
PICT' 
WPG 1 
EPS' 

KFX 

RLE 

LV 

CALS 

ATT 

CLP 

XWD 

IMG 

IFF 

SUN 

XBM 

ICO 

IOCA 

GX2 

XPM 

ASCII 

CUT 

BRK 

MAC 

PSD 

MSP 

PNG 

Photo CD 2 



ACCUSOFT 
IMAGE r« 
GUARANTEE 


Look for the 
AccuSoft Image 
Guarantee™ 
or the AccuSoft 
trademark on 
your favorite 
software products 
as a statement of 
superior quality. 
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Soft-ICE For Windows 3 95 

Raw Power To Break Through The System-level Barrier! 


Your 32-bit Application Debugger 
Is Stuck In The Win32 Subsystem, 
But The Bugs Aren't! 

When chasing a tough bug through the 
multiple layers of Windows 95, you need a 
debugger that can easily follow it. You need 
visibility and debugging power to chase 
bugs anywhere they go. When your conven¬ 
tional application debugger falls short, rely 
on Soft-ICE 2.0 for Windows 95 to pull you 
through the toughest debug sessions. 

System crash bugs are particularly frustrating 
without the right tool. Without visibility and 
control, these can take days, or even weeks 
to solve. Soft-ICE gives you visibility with it's 
internal system commands. It can show you 
what led up to the crash with its back trace 
history capability. Soft-ICE also gives you 
real control because it can debug through 
any code in any part of Windows 95. 

Soft-ICE sits right on the metal. It is not 
dependent on any system code. Its In-Circuit 
Emulator (ICE)-like features let you debug any 
Windows 95 code without side effects, and 
without expensive hardware. 

Windows 95 Is Here And 
It Means Change. 

Soft-ICE understands all of the subsystems 
that make up Windows 95. It displays rele¬ 
vant information in each subsystem and gives 
you a bearing when you find yourself in a 
part of Windows 95 that you never expected 
to end up in. 

Whether you want to dig in and learn 
Windows 95 inside out, or you want to be 
prepared for the nastiest Windows bugs, 
make Soft-ICE 2.0 for Windows 95 a part of 
your tool kit. 



4GB 


3GB 


2GB 


4MB 



Soft-ICE is the only debugger 
that lets you debug VxDs at 
source level. 


You often have to step into 
the Windows 95 system DLLs 
to chase nasty bugs. When 
you do, make sure you have 
Soft-ICE because your application 
debugger won't do. 

If you are chasing a bug that 
involves 16-bit and 32-bit code, 
Soft-ICE will get you through the 
thunks at source level. Other 
debuggers can't. 


Your 32-bit application debugger 
leaves you trapped here. 


Soft-ICE lets you switch address 
contexts so you can debug 
multiple 32-bit applications 
simultaneously. 


Some of the most difficult bugs 
are the result of real mode 
programs, TSRs or drivers. 
Soft-ICE can debug these, as 
well as everything else in 
Windows 95. 


Windows 95 Memory Map 

Get Soft-ICE For Windows 95 
And Break The Barrier! 


INC 

P.O.Box 7780 Nashua, NH 03060-7780 
Tel (603) 889-2386 • Fax (603) 889-1135 


Call 1 -800-4-NU-MEGA 

(1-800-468-6342) 

Risk = Null 30 Day Money Back Guarantee 


LIMITED TIME 
OFFER 

$399! 

PLUS SHIPPING 


Expires March 31, 1996. 
Regularly Priced At $499. 


info@numega.com 
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http://www.numega.com/ 




















